Principais Benefícios
Detecte Falhas Instantaneamente - Reaja no momento em que uma mensagem não é entregue Independente de Canal - Funciona no WhatsApp, iMessage e SMS Android Recuperação Inteligente - Automatize novas tentativas, alternativas ou alertas em caso de falha Automação Filtrada - Dispare apenas nos códigos de erro ou canais que importam para você Zero Monitoramento Manual - Não é preciso vigiar os logs em busca de envios com falhaQuem Deve Usar
Equipes de vendas - Seja notificado no instante em que uma mensagem de prospecção falha Equipes de suporte - Detecte respostas não entregues antes que elas custem um cliente Agências - Monitore a saúde de entrega em todas as subcontas de clientes Equipes de operações - Dispare alternativas e limpe dados de contato inválidos automaticamenteRequisitos
Antes de usar este gatilho, atualize seu app de provedor de mensagens para a versão mais recente:Encontre seu app de provedor de mensagens (WhatsApp provider, iMessage provider ou SMS(Android) provider)
Como Configurar
Passo 1: Crie um Novo Fluxo de Trabalho
Passo 2: Adicione o Gatilho
Passo 3: Adicione Suas Ações
Adicione as ações que você deseja executar quando uma mensagem falhar:- Enviar Notificação Interna → Alerte sua equipe dentro do CRM
- Aguardar + Reenviar → Tente enviar a mensagem novamente após um intervalo
- Atualizar Contato / Campo Personalizado → Sinalize o contato para revisão
- Criar Tarefa → Agende um acompanhamento manual
Passo 4: Salve e Publique
Filtros Disponíveis
Use filtros para controlar exatamente quais mensagens com falha iniciam o fluxo de trabalho. Cada filtro pode ser combinado com um operador (igual a, contém, etc.).| Filtro | Descrição |
|---|---|
| Contact ID | O ID único do contato para o qual a mensagem foi enviada |
| Location ID | A localização do CRM (subconta) onde a mensagem falhou |
| Error Code | O código de falha específico retornado (consulte Códigos de Erro abaixo). Escolha um ou mais. |
| Error Type | A categoria da falha retornada. Escolha uma ou mais. |
| Channel Type | O canal pelo qual a mensagem foi enviada (p. ex. whatsApp, imessage, sms) |
| Contact Phone Number | O número de telefone do contato para o qual a mensagem foi enviada |
| Whatsapp Instance Index | O índice da instância de WhatsApp que tentou o envio |
| Phone Number Used | O número do qual a mensagem foi enviada |
Códigos de Erro
Use estes códigos com o filtro Error Code para construir fluxos de recuperação precisos.| Código | O Que Significa |
|---|---|
| 101 | Não existem instâncias de WhatsApp conectadas para a localização. Nada pode ser enviado. |
| 102 | Uma substituição manual {WA#N} foi usada no corpo da mensagem, mas a instância N não existe. |
| 103 | Uma substituição manual {WA#N} foi usada, mas essa instância não está conectada no momento. |
| 104 | O contato tem uma etiqueta wa:<number>, mas esse número de WhatsApp não está conectado. |
| 105 | O usuário atribuído ao contato possui uma instância de WhatsApp, mas ela não está conectada. |
| 106 | Todas as regras de seleção de remetente foram tentadas; nenhuma instância conectada estava disponível. |
| 107 | A instância de WhatsApp do usuário GHL com sessão ativa não está conectada. |
| 108 | O fluxo de trabalho especificou um número de remetente que existe, mas está offline no momento. O sistema tentou novamente antes de falhar. |
| 109 | A API do WhatsApp rejeitou a mensagem após várias tentativas. |
| 110 | O destinatário não tem uma conta de WhatsApp. O contato também é etiquetado automaticamente com Invalid WhatsApp Number. |
| 111 | O fluxo de trabalho especificou um número de remetente que não está registrado para esta localização. |
Exemplos de Casos de Uso
Caso de Uso 1: Alerte a Equipe sobre um Envio com Falha
Saiba no momento em que uma mensagem de saída não é entregue. Gatilho: Mensagem com Falha Ação: Envie uma notificação interna ao usuário responsável.Caso de Uso 2: Limpe Números Inválidos
Sinalize contatos que não podem receber mensagens. Gatilho: Mensagem com Falha Filtro: Error Code é 110 Ação: Adicione uma etiqueta e retire o contato da prospecção ativa.Notas Importantes
Detalhes Técnicos
- O gatilho dispara uma vez por mensagem com falha
- Os filtros são opcionais: deixe-os em branco para disparar em cada mensagem com falha
- Error Code e Error Type permitem selecionar múltiplos valores
- Use o filtro Channel Type para limitar o fluxo de trabalho a um único canal
Boas Práticas
- Use o filtro Error Code para construir fluxos de recuperação direcionados (p. ex. reenviar no 108, etiquetar no 110)
- Use o filtro Channel Type quando tratar canais de forma diferente
- Teste seu fluxo de trabalho forçando uma falha (p. ex. enviando para um número desconectado)
Perguntas Frequentes
Quais canais este gatilho cobre?
Quais canais este gatilho cobre?
Todos eles - WhatsApp, iMessage e SMS Android. Use o filtro Channel Type para limitar a um único canal.
Posso disparar apenas em erros específicos?
Posso disparar apenas em erros específicos?
Sim. Os filtros Error Code e Error Type são de seleção múltipla, então você pode disparar em uma ou várias condições de falha.
Preciso adicionar filtros?
Preciso adicionar filtros?
Não. Os filtros são opcionais. Sem eles, o gatilho dispara em cada mensagem com falha.
Suporte
Se você precisar de ajuda com a configuração ou o onboarding:- Suporte via WhatsApp: Converse no WhatsApp
- Email: support@goghl.ai