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
- Abra Marketing → Automatização de contactos → Editor de automatização.
- Selecione Webhook na paleta de nós ou arraste-o para a área de edição.
- 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 .
- 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. - 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.
- 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.
- 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 Acceptedconfirma a aceitação para processamento em segundo plano, não a entrega. Guardereceipt_idpara 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.
Guias relacionados
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.