> ## Documentation Index > Fetch the complete documentation index at: https://help.goghl.ai/llms.txt > Use this file to discover all available pages before exploring further. # Gatilho Mensagem com Falha > O gatilho Mensagem com Falha é um gatilho de fluxo de trabalho personalizado que dispara automaticamente sempre que uma mensagem não consegue ser entregue. Funciona em todos os canais de mensagens - WhatsApp, iMessage e SMS Android - para que você possa reagir a falhas de entrega, alertar sua equipe ou reenviar automaticamente. *** ## Principais Benefícios[​](#principais-benefícios "Link direto para 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 falha *** ## Quem Deve Usar[​](#quem-deve-usar "Link direto para Quem 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 automaticamente *** ## Requisitos[​](#requisitos "Link direto para Requisitos") Antes de usar este gatilho, atualize seu app de provedor de mensagens para a versão mais recente: Vá para **App Marketplace → Apps Instalados** Encontre seu app de provedor de mensagens (**WhatsApp provider**, **iMessage provider** ou **SMS(Android) provider**) Clique em **Atualizar** se disponível *** ## Como Configurar[​](#como-configurar "Link direto para Como Configurar") ### Passo 1: Crie um Novo Fluxo de Trabalho[​](#passo-1-crie-um-novo-fluxo-de-trabalho "Link direto para Passo 1: Crie um Novo Fluxo de Trabalho") Vá para **Automação → Fluxos de Trabalho** Clique em **Criar Fluxo de Trabalho** ou **+ Adicionar** Selecione **Começar do Zero** ### Passo 2: Adicione o Gatilho[​](#passo-2-adicione-o-gatilho "Link direto para Passo 2: Adicione o Gatilho") Clique em **Adicionar Novo Gatilho** Mude para a aba **Apps** (não os gatilhos padrão) Encontre e clique no ícone do seu app de provedor de mensagens Selecione **Mensagem com Falha** no menu suspenso (Opcional) Adicione **Filtros** para limitar quando o gatilho dispara Clique em **Salvar gatilho** Gatilho Mensagem com Falha ### Passo 3: Adicione Suas Ações[​](#passo-3-adicione-suas-ações "Link direto para 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[​](#passo-4-salve-e-publique "Link direto para Passo 4: Salve e Publique") Revise seu fluxo de trabalho Clique em **Salvar** Alterne o fluxo de trabalho de **Rascunho** para **Publicado** *** ## Filtros Disponíveis[​](#filtros-disponíveis "Link direto para 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](#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[​](#códigos-de-erro "Link direto para 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:`, 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[​](#exemplos-de-casos-de-uso "Link direto para Exemplos de Casos de Uso") ### Caso de Uso 1: Alerte a Equipe sobre um Envio com Falha[​](#caso-de-uso-1-alerte-a-equipe-sobre-um-envio-com-falha "Link direto para 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[​](#caso-de-uso-2-limpe-números-inválidos "Link direto para 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[​](#notas-importantes "Link direto para Notas Importantes") ### Detalhes Técnicos[​](#detalhes-técnicos "Link direto para 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[​](#boas-práticas "Link direto para 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[​](#perguntas-frequentes "Link direto para Perguntas Frequentes") Todos eles - WhatsApp, iMessage e SMS Android. Use o filtro **Channel Type** para limitar a um único canal. 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. Não. Os filtros são opcionais. Sem eles, o gatilho dispara em cada mensagem com falha. *** ## Suporte[​](#suporte "Link direto para Suporte") Se você precisar de ajuda com a configuração ou o onboarding: * Suporte via WhatsApp: [Converse no WhatsApp](https://wa.me/+12267248710?text=Hi%2C%20I%20need%20help%20with%20the%20Message%20Failed%20trigger.) * Email: [**support@goghl.ai**](mailto:support@goghl.ai)