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 o URL que aparece. Configure o outro sistema para enviar os dados em JSON para esse URL, clique em Testar gatilho, escolha o pedido recebido como referência e guarde. Depois ligue os dados ao contacto com a ação Criar/atualizar contacto.

Atualizado em

Antes de começar

  • O outro sistema (loja online, plataforma de eventos, formulário externo, ferramenta de integração) tem de conseguir enviar um webhook para um URL.
  • Os dados têm de ir em formato JSON, por POST, GET ou PUT.
  • Para criar ou encontrar o contacto, os dados enviados têm de incluir o e-mail ou o telefone.
  • Esta configuração costuma ser feita por quem gere o 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. Obter o URL

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

2. Enviar um pedido de teste

  1. No outro sistema, configure o envio de dados para o URL copiado (por exemplo, sempre que entra uma encomenda).
  2. Envie um pedido de teste a partir desse sistema.
  3. No gatilho, clique em Testar gatilho. Os pedidos recebidos aparecem na lista (o mais recente no topo; use Carregar mais para ver outros).
  4. Escolha o pedido certo como referência de mapeamento e confirme o conteúdo.
  5. Clique em Guardar gatilho.

3. Ligar os dados ao contacto

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

Dicas

  • Nos nomes dos dados use palavras sem espaços (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 o URL for partilhado por engano, apague este gatilho e crie um novo: o URL antigo deixa de servir.
  • Se os dados não trazem e-mail nem telefone, pode retirar a ação Criar/atualizar contacto e usar só ações que não precisam de contacto (por exemplo, uma notificação interna).

Problemas comuns

  • Ao clicar em Testar gatilho não aparece nenhum pedido → O outro sistema ainda não enviou nada para este URL. Confirme que copiou o URL completo e envie um novo pedido de teste.
  • O contacto não é criado → Os dados não trazem e-mail nem telefone, ou esses campos não foram ligados na ação Criar/atualizar contacto.
  • 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 volte a ligar os campos.
  • O pedido é recusado → Envie em JSON e com POST, GET ou PUT. Outros formatos não são aceites.

Perguntas frequentes

Preciso de saber programar?

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

Isto foi útil?