Skip to Content

Automatizações por webhook

Consultar pedidos de leads

O gráfico agrupa os pedidos em intervalos diários, ou horários na vista de um dia. Passe o cursor ou foque com o teclado um ponto da linha para revelar o marcador e selecione-o para ver os pedidos do grupo. Cada pedido mantém a sua hora exata de receção.

Em Marketing → Automatização de contactos → Visão geral, o gráfico Pedidos de leads ao longo do tempo permite comparar os formulários e webhooks que trazem leads. Cada linha mostra o total acumulado no período: o último dia ou os últimos 7, 30 ou 90 dias. Selecione um acionador abaixo do gráfico para ocultar ou mostrar a sua linha.

Selecione um ponto para ver o nome e a data e hora de receção no seu fuso horário. Os nomes exigem acesso a Contactos e podem não estar disponíveis se o lead não tiver nome. Os pontos sobrepostos mostram todos os pedidos recebidos nesse instante. Incluem-se os leads de teste; receber um lead não significa que a tarefa tenha sido concluída com sucesso. A hora de receção pode diferir da hora de envio do formulário.

O gráfico atualiza automaticamente; Atualizar pedidos atualiza-o de imediato. Se houver mais de 5.000 pedidos, são apresentados os primeiros 5.000 e as linhas terminam no último incluído. Escolha um período mais curto para consultar pedidos posteriores.

Nas tarefas de chamadas e WhatsApp, abra Definições avançadas e escolha o país para interpretar números locais. Nos webhooks, a escolha é manual; os números internacionais mantêm o indicativo.

Um webhook inicia o follow-up de contactos vindos do seu site ou aplicação. Por exemplo, um pedido de orçamento pode iniciar uma mensagem WhatsApp com um email de alternativa e criar uma oportunidade no CRM. Não é necessário ligar o Meta Ads.

Navegação de marketing

Abra Marketing → Campanhas para campanhas telefónicas e do WhatsApp. Em Marketing → Automatização de contactos → Visão geral, consulte resultados de Instant Forms e Webhooks e configure o CRM. Edite fluxos no Editor de automatização. As ligações mantêm-se em Geral → Integrações → Plataformas de anúncios. Ligar Meta Ads abre aí a configuração. Em Marketing → Modelos do WhatsApp, selecione um canal do WhatsApp. É pedida confirmação antes de sair com alterações por guardar.

Antes de começar

Precisa de acesso às Integrações e de uma chave API que possa selecionar. Gira as suas chaves na página de chaves API , ou crie uma ao configurar o webhook. Para executar tarefas de follow-up, prepare o agente e o respetivo canal WhatsApp, caixa de correio ou número para chamadas de saída. Ligue o CRM se pretender criar oportunidades.

Adicione o webhook e a automatização

  1. Abra Marketing → Automatização de contactos → Editor de automatização.
  2. Selecione Webhook na paleta de nós ou arraste-o para a área de edição.
  3. Introduza um nome e selecione a Chave API. Criar nova chave API… cria e seleciona uma chave no mesmo diálogo. Também pode gerir as suas chaves na página de chaves API .
  4. Acrescente os dados de contacto e campos próprios, como your_field_1, aos Dados do contacto de teste. Estes ficam disponíveis nos mapeamentos de tarefas e CRM.
  5. Em Configurar CRM, escolha o funil e a fase se pretender criar oportunidades. As predefinições partilhadas de Instant Form não se aplicam a webhooks.
  6. Selecione Aplicar, ligue o webhook a uma tarefa de WhatsApp, email ou chamada e configure-a. Ligue as tarefas seguintes através de Em caso de sucesso ou Em caso de falha. Um webhook pode iniciar vários percursos independentes.
  7. Selecione Guardar no editor antes de enviar pedidos.

Um webhook pode partilhar uma tarefa e a respetiva alternativa com um Instant Form. As alterações à tarefa partilhada afetam ambos os acionadores; os mapeamentos de campos são independentes. Sem tarefas nem ações CRM, apenas é guardado o contacto. Mantenha ambos os filtros Meta em Todas para ver os webhooks.

As tarefas de email e de WhatsApp numa automatização por webhook podem voltar a contactar os leads que não respondem, tal como nos Instant Forms. Consulte Escolha os follow-ups de uma tarefa.

Chame o webhook

Pode mapear campos de tarefas ou do CRM para full_name, mesmo enviando apenas first_name e last_name: o Versafy combina-os automaticamente. Se enviar um valor não vazio em full_name, será utilizado esse valor.

O nome da oportunidade pode incluir valores dos campos do lead e as variáveis habituais de contacto e campanha. Selecione uma variável abaixo do campo do nome para a inserir na posição do cursor. Os formulários instantâneos disponibilizam os campos de resposta; os webhooks, os campos dos dados de teste. Os valores em falta ficam vazios e as respostas múltiplas são separadas por vírgulas. As oportunidades existentes mantêm os nomes.

Abra Marketing → Automatização de contactos → Editor de automatização e depois as definições do nó Webhook guardado. Copie o URL do endpoint; o Pedido de exemplo inclui o seu trigger_id. Se as definições já estiverem abertas, pode copiar diretamente o pedido completo. Gira a chave selecionada na página de chaves API . Envie o pedido a partir do servidor da aplicação; não publique a chave API no código do site. Use a chave selecionada no cabeçalho Authorization: Bearer. Substitua os marcadores do exemplo pelo seu URL, chave e ID do acionador:

curl -X POST 'YOUR_WEBHOOK_URL' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ --data '{ "trigger_id": "YOUR_TRIGGER_ID", "event_id": "quote-request-123", "first_name": "Alex", "last_name": "Smith", "company_name": "Example Company", "email": "alex@example.com", "phone_number": "+351916000000", "your_field_1": "Example value 1", "your_field_2": "Example value 2" }'

São obrigatórios trigger_id, event_id, first_name e pelo menos um de email ou phone_number. O apelido e a empresa são opcionais. Acrescente campos próprios ao mesmo nível do JSON, sem objetos aninhados. Consulte os limites e as respostas na referência da API de webhooks . A ligação Documentação API nas definições abre a mesma referência.

Use um novo event_id para cada novo envio. Ao repetir o mesmo envio, mantenha o ID e os dados: receberá o recibo original. Alterar os dados mantendo o mesmo ID devolve 409 Conflict.

Teste e consulte os resultados

Os contactos de teste exigem endereços de email e números de telefone válidos, incluindo os campos personalizados de destinatário das tarefas principais e alternativas. Corrija os campos assinalados antes de enviar; o texto de preenchimento é rejeitado. Os números sem indicativo internacional usam o país configurado na tarefa. A validação verifica o formato, não a possibilidade de receber mensagens.

Para testar um email sem executar a automatização, abra a tarefa Enviar email, selecione um remetente ligado, introduza o assunto e as instruções e selecione Enviar email de teste. Preencha os campos com valores de exemplo e envie o teste para o email da sua conta. O teste utiliza as definições da tarefa e do estilo ainda não guardadas; não guarda a tarefa, não cria contactos nem desencadeia outras ações.

Para consultar as conversas de um webhook, abra Marketing → Automatização de contactos → Visão geral e selecione um total de tarefas de WhatsApp, email ou chamadas superior a zero. Chats abre com um filtro por esse webhook e tipo de tarefa. Remova a etiqueta do filtro ou selecione Limpar tudo para alargar a lista. Este filtro está disponível apenas através destas ligações, não no seletor de filtros das conversas. Tarefas pendentes ou que falham antes do contacto podem não ter conversa; várias tarefas podem partilhar uma conversa.

No cartão de estatísticas do webhook, selecione Configurar CRM para editar a criação de oportunidades. Selecione Guardar para aplicar as definições do CRM sem abrir o editor de automações.

Em Marketing → Automatização de contactos → Visão geral, cada webhook guardado mostra o número de leads e de tarefas de WhatsApp, email e chamadas criadas. Os envios de teste estão incluídos. As tarefas criadas podem continuar pendentes ou falhar mais tarde; estes números não confirmam a entrega. Um webhook novo apresenta zeros até receber leads.

Os testes executam ações reais: podem enviar mensagens, efetuar chamadas e criar registos CRM. Use dados de contacto que controla.

Reabra o editor guardado, selecione Contacto de teste no webhook, edite os dados e selecione Enviar contacto de teste. Mantenha o diálogo aberto para ver o recibo e o estado de processamento.

Após um envio bem-sucedido, a janela prepara um novo ID de evento. Mantenha ou edite os dados e selecione Enviar outro contacto de teste para repetir o teste. Último envio identifica o recibo anterior. Se um erro de ligação interromper o pedido, repita-o sem alterar os dados para evitar duplicados.

  • 202 Accepted confirma a aceitação para processamento em segundo plano, não a entrega. Guarde receipt_id para contactar o suporte.
  • Em Geral → Contactos, pesquise por email ou telefone. Um contacto correspondente pode ser atualizado em vez de ser criado outro.
  • Em Geral → Tarefas, consulte o estado e os resultados. As tarefas do webhook mostram API como origem. Tenha em conta os atrasos e o horário de trabalho.
  • No CRM, verifique o funil e a fase selecionados, os dados do contacto e as notas de follow-up da oportunidade.

Uma tarefa pode falhar se não existir um canal de contacto utilizável. A alternativa só é executada se estiver ligada e tiver os dados necessários.

Resolução de problemas

Se o agente de email estiver no modo Dry Run ou de revisão de rascunhos, a automação não envia o email e executa a ação alternativa configurada. Sem uma ação alternativa, esse ramo falha. Mude o agente para o modo de envio para permitir emails automáticos.

Se o pedido for rejeitado, verifique as definições guardadas, o URL, o ID do acionador, a chave selecionada e os campos obrigatórios. Se for aceite mas não houver mensagem, verifique as ligações e o estado das tarefas. suppressed indica que o follow-up foi ignorado pela proteção contra duplicados; consulte as tarefas existentes antes de repetir. Se faltar a oportunidade, verifique as definições CRM deste webhook.

Atualizar oportunidades no CRM

Expanda Aplicar estas definições do CRM a outros webhooks para pesquisar outros webhooks e assinalar os pretendidos. A secção começa fechada; ao fechá-la, a seleção mantém-se para guardar depois.

Ao guardar, o grupo selecionado fica memorizado. Ao voltar a abrir qualquer webhook do grupo, os restantes ficam automaticamente assinalados. Desmarque um webhook antes de guardar para o separar do grupo. Para definições copiadas antes desta alteração, guarde uma vez com os webhooks pretendidos assinalados.

Os contactos novos de pedidos por webhook têm a origem Webhook. As automatizações do WhatsApp guardam o contacto antes do envio; a sincronização do CRM reutiliza o contacto associado. Aplicar estas definições do CRM a outros webhooks copia as definições do CRM e rejeita seleções incompatíveis sem guardar alterações. Aplicam-se as regras do CRM para formulários.

Última atualização em