{"id":15254,"date":"2022-06-27T13:19:01","date_gmt":"2022-06-27T10:19:01","guid":{"rendered":"https:\/\/snov.io\/knowledgebase\/?p=15254"},"modified":"2026-01-27T16:52:01","modified_gmt":"2026-01-27T13:52:01","slug":"como-usar-os-webhooks-da-snov-io","status":"publish","type":"post","link":"https:\/\/snov.io\/knowledgebase\/br\/como-usar-os-webhooks-da-snov-io\/","title":{"rendered":"Como configurar webhooks usando a API da Snov.io"},"content":{"rendered":"

Neste artigo, voc\u00ea aprender\u00e1 como configurar e gerenciar webhooks usando a API da Snov.io para suas integra\u00e7\u00f5es personalizadas.<\/span><\/p>\n

O que \u00e9 um webhook?<\/b><\/h2>\n

Os webhooks permitem que voc\u00ea seja notificado sobre eventos que ocorrem em suas prospec\u00e7\u00f5es por e-mail, como respostas de clientes potenciais ou conclus\u00e3o de campanhas.<\/span><\/p>\n

Basicamente, quando o evento ao qual voc\u00ea se inscreveu ocorre, a Snov.io envia dados relacionados a esse evento para o seu endpoint (URL do webhook) em tempo real. Voc\u00ea pode usar esses dados para integra\u00e7\u00f5es ou automa\u00e7\u00f5es por meio de aplicativos como Zapier ou Make.<\/span><\/p>\n

\n
\"note\"<\/div>\n
Os webhooks exigem um plano pago da Snov.io (premium). Voc\u00ea pode criar at\u00e9 50 webhooks.<\/span><\/div>\n<\/div>\n

Como criar webhooks<\/b><\/h2>\n

Para se inscrever em webhooks, escolha o evento que deseja rastrear, prepare a URL do seu endpoint e envie uma solicita\u00e7\u00e3o para a API da Snov.io.<\/span><\/p>\n

Escolha o evento<\/b><\/h3>\n

Selecione o evento que deseja rastrear na lista de eventos compat\u00edveis.<\/span><\/p>\n

Quando o evento selecionado ocorrer, a Snovio enviar\u00e1 automaticamente os dados dele para o seu endpoint.<\/span><\/p>\n

Os eventos de webhook atualmente compat\u00edveis est\u00e3o listados abaixo. Por exemplo, voc\u00ea pode receber dados de webhook quando um lead responde a um e-mail de campanha, um e-mail retorna ou um cliente potencial conclui uma campanha.<\/span><\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Objeto do webhook (event_object)<\/em><\/th>\nA\u00e7\u00e3o (event_action)<\/em><\/th>\nAtivado<\/th>\n<\/tr>\n<\/thead>\n
campaign_email<\/td>\nsent<\/td>\nQuando um e-mail \u00e9 enviado a um destinat\u00e1rio em qualquer campanha<\/span><\/td>\n<\/tr>\n
campaign_email<\/td>\nfirst_sent<\/td>\nQuando o primeiro e-mail \u00e9 enviado a um destinat\u00e1rio em qualquer campanha<\/span><\/td>\n<\/tr>\n
campaign_email<\/td>\nopened<\/td>\nQuando um destinat\u00e1rio abre um e-mail de uma campanha<\/span><\/td>\n<\/tr>\n
campaign_email<\/td>\nbounced<\/td>\nQuando um e-mail enviado de uma campanha n\u00e3o pode ser entregue e resulta em uma mensagem de erro (bounce<\/em>)<\/span><\/td>\n<\/tr>\n
campaign_reply<\/td>\nreceived<\/td>\nQuando um destinat\u00e1rio responde a um e-mail de uma campanha<\/span><\/td>\n<\/tr>\n
campaign_reply<\/td>\nfirst_received<\/td>\nQuando um destinat\u00e1rio responde a um e-mail de uma campanha pela primeira vez<\/span><\/td>\n<\/tr>\n
prospect<\/td>\ncampaign_finished<\/td>\nQuando um lead chega ao final de uma campanha e nenhuma outra a\u00e7\u00e3o est\u00e1 agendada<\/span><\/td>\n<\/tr>\n
company<\/td>\nfound_domains_by_names<\/td>\nQuando um dom\u00ednio de empresa \u00e9 encontrado com base em seu nome<\/span><\/td>\n<\/tr>\n
prospect<\/td>\nfound_by_li_url<\/td>\nQuando um perfil de potencial cliente \u00e9 encontrado com base em um URL do LinkedIn<\/span><\/td>\n<\/tr>\n
email_verification<\/td>\nverified<\/td>\nQuando uma solicita\u00e7\u00e3o de verifica\u00e7\u00e3o de e-mail \u00e9 conclu\u00edda<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Prepare a URL do seu endpoint<\/b><\/h3>\n

Esta \u00e9 a sua pr\u00f3pria URL p\u00fablica que pode aceitar solicita\u00e7\u00f5es HTTP de entrada. Por exemplo, uma URL de webhook no Zapier\/Make ou o endpoint do seu aplicativo.<\/span><\/p>\n

Envie a solicita\u00e7\u00e3o para criar o webhook<\/b><\/h3>\n

Para criar um webhook na sua conta Snov.io, use a op\u00e7\u00e3o <\/span>Adicionar endpoint de webhook da API<\/span><\/a> Snov.io.<\/span><\/p>\n

\n
\"learn\"<\/div>\n
Voc\u00ea pode se inscrever e gerenciar webhooks por meio de um conjunto de chamadas de API. Para obter detalhes completos, consulte a documenta\u00e7\u00e3o da API<\/a>. <\/span><\/div>\n<\/div>\n

.Envie uma solicita\u00e7\u00e3o de API com os par\u00e2metros abaixo. Saiba, por\u00e9m, que tais modelos de webhook s\u00e3o predefinidos com base no tipo de evento que voc\u00ea deseja rastrear.<\/span><\/p>\n

    \n
  • M\u00e9todo:<\/b> POST<\/span><\/li>\n
  • URL da solicita\u00e7\u00e3o: <\/b>https:\/\/api.snov.io\/v2\/webhooks<\/span><\/li>\n<\/ul>\n

    Par\u00e2metros do webhook<\/b><\/h3>\n
      \n
    • event_object<\/b> \u2014 o que voc\u00ea deseja rastrear, como prospecto ou e-mail (copie os valores correspondentes da tabela acima)<\/span><\/li>\n
    • event_action<\/b> \u2014 o evento espec\u00edfico que precisa ocorrer para que o webhook seja ativado (copie os valores correspondentes da tabela acima)<\/span><\/li>\n
    • endpoint_url<\/b> \u2014 forne\u00e7a seu pr\u00f3prio URL p\u00fablico para onde a Snov.io enviar\u00e1 os dados<\/span><\/li>\n<\/ul>\n

      Para criar um webhook para respostas de clientes potenciais (quando um destinat\u00e1rio responde a qualquer e-mail em qualquer campanha), escolha estes modelos:<\/span><\/p>\n

        \n
      • event_object:<\/span><\/i> campaign_reply<\/span><\/li>\n
      • event_action:<\/span><\/i> received<\/span><\/li>\n<\/ul>\n
        \n
        \n

        Exemplo de corpo de requisi\u00e7\u00e3o da API:<\/b><\/p>\n

        { \"event_object\": \"campaign_reply\", \"event_action\": \"received\", \"endpoint_url\": \"https:\/\/your-domain.com\/webhooks\/snov-replies\" }<\/span><\/i><\/p>\n<\/div>\n<\/div>\n

        Verifique se o webhook est\u00e1 funcionando<\/b><\/p>\n

        Ap\u00f3s criar o webhook:<\/span><\/p>\n

          \n
        • Certifique-se de que seu endpoint retorne um status HTTP <\/span>200\u2013299<\/b> em at\u00e9 <\/span>3 segundos<\/b><\/li>\n
        • Se o endpoint retornar um status diferente (ou expirar o tempo limite), a Snov.io tentar\u00e1 reenviar o webhook automaticamente<\/span><\/li>\n<\/ul>\n
          \n
          \"learn\"<\/div>\n
          \n

          Pol\u00edtica de repeti\u00e7\u00e3o: <\/b>o comportamento abaixo reflete como a Snov.io entrega eventos de webhook na pr\u00e1tica.<\/span><\/p>\n

           <\/p>\n

          O webhook \u00e9 considerado bem-sucedido se a Snov.io receber um status HTTP no intervalo de 200 a 299 em at\u00e9 3 segundos.<\/span><\/p>\n

          Em outras palavras, se recebermos qualquer outro status HTTP ou ocorrer um tempo limite, faremos sete tentativas de repeti\u00e7\u00e3o com intervalos crescentes, at\u00e9 38 horas ap\u00f3s o evento que disparou o webhook:<\/span><\/p>\n

          Se todas as tentativas falharem, o webhook ser\u00e1 desativado.<\/span><\/p>\n

            \n
          • <\/li>\n<\/ul>\n
              \n
            • 1\u00aa: imediatamente ap\u00f3s o evento<\/span><\/li>\n
            • 2\u00aa: 20 minutos ap\u00f3s a \u00faltima tentativa (20 minutos ap\u00f3s o evento)<\/span><\/li>\n
            • 3\u00aa: 40 minutos ap\u00f3s a \u00faltima tentativa (1 hora ap\u00f3s o evento)<\/span><\/li>\n
            • 4\u00aa: 60 minutos ap\u00f3s a \u00faltima tentativa (2 horas ap\u00f3s o evento)<\/span><\/li>\n
            • 5\u00aa: 4 horas ap\u00f3s a \u00faltima tentativa (6 horas ap\u00f3s o evento)<\/span><\/li>\n
            • 6\u00aa: 8 horas ap\u00f3s a \u00faltima tentativa (14 horas ap\u00f3s o evento)<\/span><\/li>\n
            • 7\u00aa: 24 horas ap\u00f3s a \u00faltima tentativa (38 horas ap\u00f3s o evento)<\/span><\/li>\n<\/ul>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

              Neste artigo, voc\u00ea aprender\u00e1 como configurar e gerenciar webhooks usando a API da Snov.io para suas integra\u00e7\u00f5es personalizadas. O que \u00e9 um webhook? Os webhooks permitem que voc\u00ea seja notificado sobre eventos que ocorrem em suas prospec\u00e7\u00f5es por e-mail, como respostas de clientes potenciais ou conclus\u00e3o de campanhas. Basicamente, quando o evento ao qual voc\u00ea […]<\/p>\n","protected":false},"author":17,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2310],"tags":[],"_links":{"self":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/15254"}],"collection":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/comments?post=15254"}],"version-history":[{"count":4,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/15254\/revisions"}],"predecessor-version":[{"id":44513,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/15254\/revisions\/44513"}],"wp:attachment":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/media?parent=15254"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/categories?post=15254"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/tags?post=15254"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}