Saltar para o conteúdo
Elooo CRMCentral de Ajuda Ir para o site

Gatilhos

Como iniciar um workflow com dados de outro sistema (webhook de entrada)

No workflow, adicione o gatilho Webhook de entrada e copie a URL que aparece. Configure o outro sistema para enviar os dados em JSON para essa URL, clique em Testar gatilho, escolha a requisição recebida como referência e salve. Depois ligue os dados ao contato com a ação Criar/atualizar contato.

Atualizado em

Antes de começar

  • O outro sistema (loja virtual, plataforma de eventos, formulário externo, ferramenta de integração) precisa conseguir enviar um webhook para uma URL.
  • Os dados precisam ir em formato JSON, por POST, GET ou PUT.
  • Para criar ou encontrar o contato, os dados enviados precisam incluir e-mail ou telefone.
  • Essa configuração costuma ser feita por quem cuida do outro sistema. Tenha essa pessoa por perto.
Onde encontrar

Automação › Workflows › (abrir o workflow) › Adicionar novo gatilho › Webhook de entrada

Passo a passo

1. Pegar a URL

  1. Abra Automação › Workflows e crie um workflow novo.
  2. Clique em Adicionar novo gatilho e escolha Webhook de entrada.
  3. Copie a URL do webhook que aparece. Ela é única para este gatilho.

2. Enviar uma requisição de teste

  1. No outro sistema, configure o envio de dados para a URL copiada (por exemplo, sempre que entrar um pedido).
  2. Envie uma requisição de teste a partir desse sistema.
  3. No gatilho, clique em Testar gatilho. As requisições recebidas aparecem na lista (a mais recente no topo; use Carregar mais para ver outras).
  4. Escolha a requisição certa como referência de mapeamento e confira o conteúdo.
  5. Clique em Salvar gatilho.

3. Ligar os dados ao contato

  1. Depois de salvar, o workflow sugere a ação Criar/atualizar contato.
  2. Ligue cada campo do contato (nome, e-mail, telefone…) ao dado correspondente recebido.
  3. Salve a ação e adicione as demais ações (tag, e-mail, notificação…). Os dados do webhook podem ser usados como valores personalizados nas mensagens e nas condições Se/Senão.
  4. Salve e publique o workflow.

Dicas

  • Nos nomes dos dados, use palavras sem espaço (por exemplo, primeiroNome ou primeiro_nome).
  • Se a estrutura dos dados mudar no outro sistema, volte ao gatilho e escolha de novo a referência de mapeamento.
  • Se a URL for compartilhada por engano, exclua este gatilho e crie um novo: a URL antiga deixa de funcionar.
  • Se os dados não trazem e-mail nem telefone, você pode tirar a ação Criar/atualizar contato e usar só ações que não precisam de contato (por exemplo, uma notificação interna).

Problemas comuns

  • Ao clicar em Testar gatilho não aparece nenhuma requisição → O outro sistema ainda não enviou nada para essa URL. Confira se copiou a URL completa e envie uma nova requisição de teste.
  • O contato não é criado → Os dados não trazem e-mail nem telefone, ou esses campos não foram ligados na ação Criar/atualizar contato.
  • Os campos chegam vazios nas mensagens → A estrutura dos dados mudou ou a referência escolhida é antiga. Escolha de novo a referência de mapeamento e ligue os campos outra vez.
  • A requisição é recusada → Envie em JSON e com POST, GET ou PUT. Outros formatos não são aceitos.

Perguntas frequentes

Preciso saber programar?

Do lado do Elooo CRM, não. Do lado do outro sistema, você precisa de alguém que saiba configurar o envio do webhook.

Isso foi útil?