Webhook: receba informações de outras plataformas e ative automações

Os webhooks são gatilhos de automações na Pingback. Eles permitem que você inicie um workflow automaticamente a partir de ações externas, como mudanças em um CRM ou qualquer outra aplicação que envie uma requisição para o webhook.

O que é um webhook?

Um webhook é uma URL única gerada para cada automação. Sempre que essa URL recebe uma requisição POST, ela aciona a automação vinculada e executa as etapas configuradas no fluxo.

Exemplo de estrutura da URL:

https://connect.pingback.com/v2/webhook/{webhookId}/c/{channelUid}/w/{workflowId}

Como funciona na prática?

Imagine que você possui um CRM onde seus contatos mudam de estágio. Quando um contato sai de Prospecção e vai para Provável, você pode configurar o CRM para enviar uma requisição para o webhook da Pingback com os dados do contato.

Assim, sempre que essa mudança ocorrer, a Pingback recebe os dados e inicia automaticamente o workflow configurado.

Criando um webhook na Pingback

Para criar um webhook, basta:

  1. Acessar o menu de Automações.

  2. Criar uma nova automação.

  3. Selecionar o gatilho Webhook.

  4. Copiar a URL gerada e utilizá-la em suas integrações externas.

Como enviar dados para o webhook

  • Método da requisição: POST

  • Headers: não são necessários

  • Body: deve conter os dados do contato em JSON

Exemplo de body:

{
  "email": "contato@exemplo.com",
  "customFields": [
    {
      "fieldName": "name",
      "fieldValue": "João Silva"
    },
    {
      "fieldName": "phone",
      "fieldValue": "+5511950582614"
    },
    {
      "fieldName": "cargo",
      "fieldValue": "Gerente Comercial"
    }
  ]
}

Observações importantes:

  • O campo email é o único obrigatório.

  • Os customFields podem ser enviados em quantidade ilimitada, desde que os fieldName já estejam criados previamente na plataforma.

  • 👉 Veja como criar e gerenciar custom fields neste artigo.

Possíveis erros e soluções

  • Erro 400 (MISSING_BODY): ocorre quando nenhum body foi enviado.

  • Erro 422 (INVALID_INPUT): o objeto body foi enviado em formato inválido.

    • Certifique-se de enviar um JSON válido.

    • Verifique se os fieldName correspondem exatamente aos criados na plataforma.

Detalhes do contato

Nas informações detalhadas do contato, é possível verificar quando ele foi enviado via Webhook. Caso algum customField tenha sido enviado, o contato também será atualizado.

Esse recurso é extremamente útil para integrar a Pingback ao seu ecossistema de ferramentas e garantir que seus fluxos de automação sejam acionados no momento exato em que o contato realiza uma ação importante em outro sistema.

Was this helpful?