{"id":25441,"date":"2025-08-11T10:15:37","date_gmt":"2025-08-11T10:15:37","guid":{"rendered":"https:\/\/clockify.me\/help\/?p=25441"},"modified":"2026-03-03T06:49:30","modified_gmt":"2026-03-03T06:49:30","slug":"api-webhook-settings","status":"publish","type":"post","link":"https:\/\/clockify.me\/help\/pt\/administration\/api-webhook-settings","title":{"rendered":"Configura\u00e7\u00f5es de API e webhook"},"content":{"rendered":"
Quem pode usar esta funcionalidade?<\/span>
<\/rect><\/mask><\/path><\/g><\/svg>Todos os usu\u00e1rios (API); Propriet\u00e1rios e administradores do espa\u00e7o de trabalho (configura\u00e7\u00f5es de Webhook)<\/span><\/div>
<\/rect><\/mask><\/path><\/g><\/svg>No plano gratuito e nos planos pagos<\/span><\/div><\/div><\/div>\n\n\n\n

O Clockify permite que voc\u00ea gerencie e configure configura\u00e7\u00f5es avan\u00e7adas para o seu perfil, como webhooks<\/strong> e chaves de API<\/strong>. Dessa forma, voc\u00ea tem mais controle sobre a seguran\u00e7a e a efici\u00eancia da sua conta.<\/p>\n\n\n\n

Chaves de API<\/h2>\n\n\n\n

\u00c9 importante salvar suas chaves de API em um local seguro. Se voc\u00ea perder uma chave ou n\u00e3o salv\u00e1-la, gerar uma nova desativar\u00e1 a chave antiga, potencialmente interrompendo configura\u00e7\u00f5es e integra\u00e7\u00f5es existentes.
No Clockify, voc\u00ea pode salvar suas chaves de API e edit\u00e1-las conforme necess\u00e1rio.<\/p>\n\n\n\n

Encontre as configura\u00e7\u00f5es da sua chave de API na guia Avan\u00e7ado<\/strong> das suas Configura\u00e7\u00f5es de perfil<\/strong>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Clique no bot\u00e3o Gerenciar chaves de API<\/strong> e veja uma lista de todas as APIs que voc\u00ea gerou na p\u00e1gina que se abre. <\/p>\n\n\n\n

Aqui, voc\u00ea pode gerenciar suas chaves de API de algumas maneiras diferentes. <\/p>\n\n\n\n

Gerar chave de API<\/strong><\/h3>\n\n\n\n

Para criar uma nova chave:<\/p>\n\n\n\n

    \n
  1. Clique em Gerar nova<\/strong> no canto superior direito da p\u00e1gina<\/li>\n\n\n\n
  2. A janela Gerar chave de API ser\u00e1 aberta <\/li>\n\n\n\n
  3. Digite um nome para sua nova chave de API
    D\u00ea um nome descritivo para que voc\u00ea saiba para que ela serve <\/strong><\/li>\n\n\n\n
  4. Clique em Gerar<\/strong><\/li>\n<\/ol>\n\n\n\n

    Sua nova chave ser\u00e1 criada automaticamente e adicionada \u00e0 lista na p\u00e1gina Gerenciar chaves de API<\/strong>.<\/p>\n\n\n\n

    Editar chave de API<\/strong><\/h3>\n\n\n\n

    Se voc\u00ea precisar fazer algumas altera\u00e7\u00f5es na chave de API:<\/p>\n\n\n\n

      \n
    1. Clique no menu de tr\u00eas pontos<\/strong> ao lado da chave de API que voc\u00ea deseja desativar<\/li>\n\n\n\n
    2. Escolha a op\u00e7\u00e3o Renomear\/Excluir<\/strong>\"\"<\/li>\n\n\n\n
    3. Digite o novo nome ou clique em Excluir<\/strong> para confirmar a a\u00e7\u00e3o<\/li>\n<\/ol>\n\n\n\n

      O novo nome da chave de API \u00e9 atualizado automaticamente na p\u00e1gina Gerenciar chaves de API<\/strong>.
      Ap\u00f3s ser exclu\u00edda, essa chave de API n\u00e3o pode mais ser usada e \u00e9 automaticamente removida da p\u00e1gina Gerenciar chaves de API<\/strong> e da guia Contas<\/strong> nas Configura\u00e7\u00f5es do espa\u00e7o de trabalho<\/strong>.<\/p>\n\n\n\n

      Webhooks<\/h2>\n\n\n\n
      <\/rect><\/mask><\/path><\/g><\/svg>Nota<\/span><\/div>
      \n

      Esta funcionalidade est\u00e1 dispon\u00edvel para propriet\u00e1rios e administradores do espa\u00e7o de trabalho. A se\u00e7\u00e3o de webhooks n\u00e3o \u00e9 vis\u00edvel para outras fun\u00e7\u00f5es de usu\u00e1rio.<\/p>\n<\/div><\/div>\n\n\n\n

      Crie webhooks para receber notifica\u00e7\u00f5es em tempo real e atualiza\u00e7\u00f5es de dados.<\/p>\n\n\n\n

      Siga estes passos:<\/p>\n\n\n\n

        \n
      1. V\u00e1 para a p\u00e1gina Prefer\u00eancias<\/strong><\/li>\n\n\n\n
      2. Selecione a guia Avan\u00e7ado<\/strong><\/li>\n\n\n\n
      3. Na se\u00e7\u00e3o Webhooks<\/strong>, clique em Gerenciar webhooks<\/strong><\/li>\n\n\n\n
      4. Voc\u00ea ser\u00e1 redirecionado para a p\u00e1gina Webhooks<\/strong><\/li>\n<\/ol>\n\n\n\n

        Se voc\u00ea faz parte de v\u00e1rios espa\u00e7os de trabalho, escolha o espa\u00e7o de trabalho relevante.<\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        Para criar um novo webhook:<\/p>\n\n\n\n

          \n
        1. Clique no bot\u00e3o Criar novo<\/strong> no canto superior direito<\/li>\n\n\n\n
        2. Na janela Criar webhook<\/strong>, forne\u00e7a os seguintes detalhes:
          \"\"
          Nome<\/strong>: Especifique um nome para seu webhook
          Ponto de extremidade<\/strong>: Insira a URL do ponto de extremidade do webhook
          Evento<\/strong>: Escolha o evento que acionar\u00e1 o webhook<\/li>\n\n\n\n
        3. Clique em Criar<\/strong> para concluir o processo<\/li>\n<\/ol>\n\n\n\n

          Se voc\u00ea faz parte de v\u00e1rios espa\u00e7os de trabalho, escolha o espa\u00e7o de trabalho relevante.<\/p>\n\n\n\n

          Os eventos de webhook criados s\u00e3o classificados em ordem alfab\u00e9tica. <\/p>\n\n\n\n

          <\/rect><\/mask><\/path><\/g><\/svg>Nota<\/span><\/div>
          \n

          O evento de webhook pode ser desativado durante a cria\u00e7\u00e3o, caso o espa\u00e7o de trabalho do Clockify n\u00e3o esteja em um plano de assinatura que ofere\u00e7a suporte a essa funcionalidade.  <\/p>\n<\/div><\/div>\n\n\n\n

          Detalhes do webhook<\/h3>\n\n\n\n

          Se quiser ver os detalhes do webhook, voc\u00ea pode fazer isso abrindo o menu de tr\u00eas pontos desse webhook. <\/p>\n\n\n\n

            \n
          • V\u00e1 para o webhook que voc\u00ea gostaria de examinar<\/li>\n\n\n\n
          • Abra Detalhes<\/strong> no menu de tr\u00eas pontos <\/li>\n\n\n\n
          •  Uma nova p\u00e1gina \u00e9 aberta com a lista de tentativas de webhook<\/strong> <\/li>\n<\/ul>\n\n\n\n

            Aqui, voc\u00ea pode ver o hor\u00e1rio da tentativa e o status do evento. <\/p>\n\n\n\n

            <\/rect><\/mask><\/path><\/g><\/svg>Nota<\/span><\/div>
            \n

            O hor\u00e1rio da tentativa segue o formato definido nas prefer\u00eancias.<\/p>\n<\/div><\/div>\n\n\n\n

            O webhook de teste tamb\u00e9m pode ser exibido nas tentativas de webhook com o status e a carga \u00fatil apropriados. <\/p>\n\n\n\n

            Mecanismo de nova tentativa de webhook<\/h3>\n\n\n\n

            O Clockify utiliza um mecanismo autom\u00e1tico de nova tentativa para lidar com indisponibilidade tempor\u00e1rias ou problemas no endpoint. <\/p>\n\n\n\n

            Se o seu dom\u00ednio estiver indispon\u00edvel, o sistema tentar\u00e1 automaticamente reenviar o webhook at\u00e9 4 vezes ao longo de um per\u00edodo de 72 horas: <\/p>\n\n\n\n

              \n
            • 1\u00aa tentativa: 12 segundos ap\u00f3s a falha<\/li>\n\n\n\n
            • 2\u00aa tentativa: 10 minutos depois<\/li>\n\n\n\n
            • 3\u00aa tentativa: 30 minutos depois<\/li>\n\n\n\n
            • 4\u00aa tentativa: 72 horas depois (para indisponibilidade prolongada)<\/li>\n<\/ul>\n\n\n\n
              <\/rect><\/mask><\/path><\/g><\/svg>Informa\u00e7\u00e3o<\/span><\/div>
              \n

              Apenas respostas HTTP 2xx s\u00e3o marcadas como \"Conclu\u00eddo\". Respostas com timeout ou n\u00e3o-2xx s\u00e3o marcadas como \"Falhou\" ou \"Tentando novamente\".<\/p>\n<\/div><\/div>\n\n\n\n

              Voc\u00ea pode clicar em Reenviar<\/strong> em qualquer tentativa de webhook, independentemente do status atual. Se o reenvio manual for bem-sucedido, o status ser\u00e1 atualizado para Conclu\u00eddo<\/strong>.<\/p>\n\n\n\n

              H\u00e1 um sistema de cores na aba Prefer\u00eancias para ajudar voc\u00ea a acompanhar os status rapidamente: <\/p>\n\n\n\n

                \n
              • Status do Webhook<\/strong>: Ativo, Desativado<\/li>\n\n\n\n
              • Status da tentativa<\/strong>: Conclu\u00eddo, Tentando novamente, Falhou <\/li>\n<\/ul>\n\n\n\n
                \"\"<\/figure>\n\n\n\n

                Editar webhook<\/h3>\n\n\n\n

                Se voc\u00ea quiser modificar quaisquer dados relacionados aos webhooks, voc\u00ea pode fazer isso escolhendo a op\u00e7\u00e3o de edi\u00e7\u00e3o.<\/p>\n\n\n\n

                  \n
                • Acesse o webhook que deseja editar<\/li>\n\n\n\n
                • Abra Editar<\/strong> no menu de tr\u00eas pontos <\/li>\n\n\n\n
                •  Uma nova p\u00e1gina \u00e9 aberta com a lista de tentativas de webhook<\/strong> <\/li>\n<\/ul>\n\n\n\n

                  Aqui voc\u00ea pode modificar todos os elementos do webhook criado: <\/p>\n\n\n\n

                    \n
                  • Alterar nome do webhook<\/li>\n\n\n\n
                  • Alterar URL do ponto de extremidade<\/li>\n\n\n\n
                  • Selecionar outro evento no menu suspenso<\/li>\n\n\n\n
                  • Alterar (redefinir) Segredo de assinatura<\/strong> <\/li>\n<\/ul>\n\n\n\n

                    Excluir webhook<\/h3>\n\n\n\n

                    Se voc\u00ea quiser excluir um webhook que est\u00e1 obsoleto ou que n\u00e3o est\u00e1 mais usando, voc\u00ea pode fazer isso da seguinte maneira: <\/p>\n\n\n\n

                      \n
                    • Acesse o webhook que deseja editar<\/li>\n\n\n\n
                    • Selecione Excluir<\/strong> no menu de tr\u00eas pontos <\/li>\n\n\n\n
                    • Clique em Excluir<\/strong> na janela de confirma\u00e7\u00e3o<\/li>\n<\/ul>\n\n\n\n

                      Webhooks do Marketplace<\/h3>\n\n\n\n

                      No marketplace do Clockify, usu\u00e1rios de complementos (add-ons) n\u00e3o t\u00eam o bot\u00e3o Reenviar<\/strong> nas tentativas de webhook do complemento.<\/p>","protected":false},"excerpt":{"rendered":"Clockify allows you to manage and configure advanced settings for your profile s…","protected":false},"author":25,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_helpful_status":1,"_searchwp_excluded":"","footnotes":""},"categories":[29],"tags":[],"class_list":["post-25441","post","type-post","status-publish","format-standard","hentry","category-my-account"],"acf":[],"featured_image_src":null,"author_info":{"display_name":"tamara radijevac","author_link":"https:\/\/clockify.me\/help\/pt\/author\/tamara-radijevac"},"_links":{"self":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts\/25441","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/users\/25"}],"replies":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/comments?post=25441"}],"version-history":[{"count":16,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts\/25441\/revisions"}],"predecessor-version":[{"id":30025,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/posts\/25441\/revisions\/30025"}],"wp:attachment":[{"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/media?parent=25441"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/categories?post=25441"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clockify.me\/help\/pt\/wp-json\/wp\/v2\/tags?post=25441"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}