Uma mensagem não está sendo enviada
Cada mensagem enviada pelo REDA Connect é um registro de Mensagem Connect que informa exatamente o que aconteceu: Status mostra até onde chegou e Mensagem de erro explica por que parou. Este artigo segue por sintomas: encontre o seu, verifique e corrija. Os textos de erro são citados como aparecem na tela para você comparar letra por letra.
- Abra o registro da mensagem: encontre-a no Feed Connect e clique no ícone do canal ao lado do horário, ou abra a guia Mensagens Connect (Iniciador de aplicativos →
Mensagens Connect) e use All Outbound Messages ou Failed Messages. - Mantenha visíveis Status, Mensagem de erro e Enviar mensagem. Se não aparecerem, consulte o administrador: o acesso vem com os conjuntos de permissões do REDA Connect; consulte Dar acesso à sua equipe.
Sintoma 1: a mensagem está parada, Status está vazio e nada acontece
Uma mensagem com Status vazio foi criada, mas nunca foi entregue ao WhatsApp ou Twilio. O REDA Connect só despacha uma mensagem criada como registro quando Enviar mensagem está marcado. A ajuda explica que, ao marcar, a automação tenta enviá-la pelo canal selecionado. Mensagens do Feed Connect não usam essa caixa: saem imediatamente. Por isso, uma mensagem parada com status vazio quase sempre vem de um registro criado diretamente por você ou uma automação.
| Verificação | O que encontra | Correção |
|---|---|---|
| Enviar mensagem está desmarcado? | A mensagem foi salva sem a instrução de envio. | Edite e marque Enviar mensagem: o REDA Connect a despacha imediatamente. Só funciona enquanto Status continuar vazio. |
| Data/hora de agendamento tem um valor futuro? | É uma mensagem agendada que aguarda intencionalmente. | Não há nada a corrigir: ela sai no horário previsto. Consulte Agendar mensagens. |
| Enviar mensagem está marcado, mas Status continua vazio. | O trabalho de envio em segundo plano encontrou um problema do sistema. | Procure na guia Registros Connect um registro criado perto do mesmo horário. |
Resultado esperado: em um minuto após marcar Enviar mensagem, Status muda para Enviado no WhatsApp ou Na fila/Aceito no SMS se funcionar; se falhar, muda para Falhou com uma Mensagem de erro que você pode procurar abaixo.
Sintoma 2: Status é Falhou e Mensagem de erro começa com CONNECT_API ->
Uma mensagem de erro que começa com CONNECT_API -> identifica uma exceção no processo de envio do Connect. Configuração e conteúdo são causas comuns, mas o prefixo sozinho não comprova que nenhuma chamada ao provedor ocorreu. Leia o motivo incluído no erro:
| Texto dentro do erro | Causa | Correção |
|---|---|---|
Configuração de conta com falha no Connect. | A Conta Connect não pode enviar pelo canal: Ativo está desmarcado, falta um campo obrigatório —no WhatsApp, endpoint de API, token ou número; no SMS, endpoint, número remetente ou credenciais— ou o canal não está selecionado em Canais de mensagens. | Abra a conta, marque Ativo, preencha os campos e confirme que Canais de mensagens inclui o canal. Consulte Criar uma Conta Connect. |
3. Solicitação inválida - Forneça o corpo da mensagem ou o modelo de conexão. | A mensagem não tem um corpo utilizável nem um modelo. O procedimento documentado de criação direta, incluindo mensagens agendadas, usa um Modelo Connect; o feed monta o corpo a partir do texto informado. | Adicione um Modelo Connect ativo ou envie pelo feed. Consulte Agendar mensagens. |
4. Solicitação inválida - Arquivo não encontrado. | Não foi encontrado um link de arquivo utilizável para este envio de imagem ou documento sem modelo | Anexe o arquivo à mensagem ou reenvie pelo feed com o arquivo; consulte Enviar arquivos, imagens e vídeos. |
4. Tipo de mensagem não suportado para SMS. | SMS só aceita Texto e a mensagem tem outro tipo. | Altere Tipo de mensagem para Texto ou use WhatsApp para mídia; consulte O que você pode enviar em cada canal. |
5. Erro de modelo: seguido de Os parâmetros de entrada fornecidos são inválidos. | Foi enviado um modelo com campos de mesclagem sem um registro válido do seu objeto para mesclar. | Garanta que a mensagem tenha um registro do Objeto aplicável do modelo; consulte Campos de mesclagem. |
Solicitação inválida - Não foi possível gerar o corpo da solicitação. | O REDA Connect não pode enviar esse tipo de mensagem por esse canal. | Crie outra mensagem com um tipo aceito; consulte O que você pode enviar em cada canal. |
Sintoma 3: Status é Falhou e Mensagem de erro é texto sem CONNECT_API ->
Sem o prefixo CONNECT_API ->, o texto pode ser uma resposta do provedor. Para confirmar por que a mensagem foi rejeitada, leia Mensagem de erro e os detalhes disponíveis da resposta. O formato do texto sozinho não comprova o caminho de entrega.
| O que o texto do provedor sugere | Correção |
|---|---|
| Autenticação, autorização, token expirado ou credenciais inválidas. | O token ou as chaves de API salvos estão incorretos ou expiraram. Atualize-os com segurança: Atualizar seus tokens de API com segurança. |
| Número de destinatário inválido, não verificado ou não compatível. | Confira se é um celular real em formato internacional somente com dígitos; consulte Como inserir números de telefone. |
| Restrições de modelos, janela de mensagens ou políticas do WhatsApp. | Fora da janela de atendimento de 24 horas, o WhatsApp só aceita modelos aprovados; consulte Modelos de mensagens do WhatsApp e aprovação da Meta. |
| Qualquer texto que você não consiga interpretar. | Copie o texto exato na busca da documentação de códigos de erro do provedor; Meta e Twilio publicam a sua. Ou contate o suporte da REDA com o número da Mensagem Connect. |
Corpo da resposta guarda a resposta completa e bruta do provedor para diagnóstico; é útil ao contatar o suporte.
Sintoma 4: o Salesforce nem permite criar a mensagem
Esses erros aparecem ao salvar, ou na tela durante um envio, porque uma regra bloqueia a mensagem antes de despachá-la:
| Texto exato do erro | Causa | Correção |
|---|---|---|
O destinatário optou por não receber mensagens SMS. | O Lead ou Contato vinculado tem a recusa de SMS marcada. | Respeite-a ou, com o consentimento renovado do cliente, consulte Campos de recusa de mensagens nos registros. |
O destinatário optou por não receber mensagens do WhatsApp. | O mesmo para WhatsApp. | Igual ao acima. |
O valor do número de telefone de destino deve ser fornecido para mensagens de saída. | A mensagem não tem número destinatário; normalmente o campo do registro está vazio ou não está configurado. | Preencha o telefone no formato correto (Como inserir números de telefone) e confira se a configuração aponta para o campo certo (Visão geral da configuração de objetos). |
Em envios em massa, um único destinatário que recusou mensagens bloqueia todo o lote com esse erro; consulte Acompanhar um envio em massa.
Exemplo prático
Uma mensagem mostra Status Falhou com Mensagem de erro CONNECT_API -> Configuração de conta com falha no Connect. -> Line Number: …. O prefixo indica que o REDA Connect a interrompeu e a frase interna aponta a configuração da conta. Você abre a conta e encontra Ativo desmarcado durante a rotação de tokens da semana anterior. Marca e volta à mensagem, mas o status já está definido, então envia uma nova pelo feed. Ela sai com Status Enviado.
Perguntas frequentes
Não com o mesmo registro: depois de definido o Status, esse registro não é despachado novamente. Corrija a causa e envie um novo, pelo feed ou como registro novo com Enviar mensagem marcado.
Na fila, Enviando, Aceito, Enviado, Entregue, Lido, Falhou, Não entregue, Recebendo e Recebido: o ciclo completo é explicado em Entender os status de entrega.
Enviado significa que o provedor a aceitou. Se não avançar para Entregue, o problema está depois: telefone desligado, número inacessível ou confirmações que não chegam. Para confirmações de SMS, consulte a nota da barra final em Criar o Site público para receber mensagens.
Em Failed Messages da guia Mensagens Connect, ou crie um relatório: Relatórios e painéis e Receber notificações de erros.
Próximos caminhos
- Índice de solução de problemas: cada sintoma em uma tabela pesquisável.
- Uma mensagem recebida não chegou: o problema equivalente de recebimento.
- Atualizar seus tokens de API com segurança: corrigir rejeições por credenciais sem quebrar a criptografia.