📋 Requisitos Previos e Casos de Uso
Esta funcionalidade permite que o Atom envie atualizações sobre o status de entrega de templates do WhatsApp diretamente para objetos do HubSpot (Contato, Negócio ou Ticket).
Pré-condições necessárias
Ter conectada e ativa a integração nativa entre Atom e HubSpot.
Ter criado previamente uma campanha do tipo Webhook no Atom.
Contar com o papel de Administrador na plataforma Atom.
⚠️ Importante: Para enviar esses campos para o objeto Contato do HubSpot, o contato deve estar previamente vinculado com o Atom e não apresentar conflitos de duplicidade.
Casos de Uso Principais
Omnicanalidade Inteligente: Enviar um e-mail a partir de um Workflow do HubSpot para clientes que não puderam ser contatados pelo WhatsApp (ex: número sem WhatsApp ativo ou falhas de entrega).
Acompanhamento de Não Respondidos: Ativar comunicações secundárias se o usuário não responder à mensagem inicial no tempo configurado.
Gestão de Filtros do Meta: Identificar e reorientar mensagens bloqueadas por experimentos do Meta, limites de envio ou restrições de usuário (MM Lite).
⚙️ Configuração do Fluxo e Mapeamento no HubSpot
Para reportar corretamente os eventos de envio para o CRM, você deve vincular o identificador único do registro do HubSpot dentro da campanha do Atom:
Duplicar o fluxo no Atom: Acesse sua campanha Webhook no Atom, duplique-a e no componente de Webhook adicione um campo de informação destinado a armazenar o ID do contato do HubSpot (ex:
crm_id).
Configurar o Workflow no HubSpot: No Workflow do HubSpot configurado para enviar o webhook do Atom, mapeie o campo criado na etapa anterior (
crm_id) atribuindo-lhe o valor Id de registro do contato.
Mapear os status de envio: Acesse a configuração de status de envio no Atom e selecione o campo personalizado da etapa 1 como o identificador de destino.
Rota: Automatizações > Webhooks > Ações
🧩 Campos Sincronizados e Ciclo de Vida do Envio
Cada atualização que o Meta ou o Atom processam sobre o envio do template gera um evento automático para o registro associado no HubSpot:
Campos de Informação Disponíveis
Status de envio do template: Status atual no ciclo de vida da mensagem.
Código e Descrição do erro: Identificadores e detalhes devolvidos pelo Meta em caso de falha (úteis para diagnosticar na documentação oficial do Meta).
Nome e Id do Webhook: Dados que identificam a campanha originária no Atom para auditorias de suporte.
Nome e Id do template: Identificadores da mensagem estruturada enviada.
Canal: Número de telefone do WhatsApp utilizado para a saída da mensagem.
Matriz de Status de Envio
Status | Origem | Detalhe Operativo |
Enviado | Meta | Confirmação inicial do Meta após receber a solicitação sem erros anteriores. Status transitório anterior à entrega. |
Entregue | Meta | Mensagem recebida com sucesso no dispositivo do cliente. A notificação para o HubSpot leva apenas alguns segundos. |
Lido | Meta | O usuário abre a mensagem. (Nota: Não será notificado se o cliente tiver a confirmação de leitura desativada). |
Falho | Meta / Atom | Ocorre por problemas do Meta (falta de rede, limites de tier, experimentos do Meta, MM Lite) ou do Atom (template desativado, canal desconectado, formato de telefone inválido). |
Fluxo Expirado | Atom | A mensagem foi entregue mas o usuário não abriu nem respondeu durante o tempo limite configurado. |
Respondido | Atom | O cliente responde ativamente à primeira mensagem do template. |
Bloqueado | Atom | A tentativa de envio é interrompida porque o destinatário está na lista de clientes bloqueados do Atom. |
💡 Dica: Você pode criar Workflows no HubSpot ativados exclusivamente quando o status do template mudar para Falho ou Fluxo Expirado para enviar um e-mail de backup imediatamente, garantindo zero perda de contatos críticos.
Configurar o rastreamento de status de suas campanhas Webhook oferece visibilidade total sobre o alcance de suas comunicações. Converta as falhas de entrega em oportunidades de retentativa omnicanal e garanta que sua mensagem sempre chegue ao cliente certo. ✅