Índice de solução de problemas: sintoma, causa e correção
Esta é a tabela geral de consulta para problemas do REDA Connect. Procure a linha que descreve o seu com a busca do navegador, Ctrl+F / Cmd+F, leia a causa resumida e siga o link para a correção completa. Erros em estilo de código são citados como aparecem na tela. Se seu sintoma não estiver aqui, comece pelos dois guias principais: Uma mensagem não está sendo enviada e Uma mensagem recebida não chegou.
Problemas de envio
| Sintoma | Causa | Correção |
|---|---|---|
| Mensagem parada: Status continua vazio e nada acontece. | O registro foi criado sem marcar Enviar mensagem, então nunca foi despachado. | Uma mensagem não está sendo enviada |
Mensagem com status Falhou e um erro técnico longo que começa com CONNECT_API ->. | O processo do Connect informou uma exceção. Leia a causa: o prefixo sozinho não comprova onde a entrega parou | Uma mensagem não está sendo enviada |
O erro contém Configuração de conta com falha no Connect. | A Conta Connect está inativa, faltam campos obrigatórios do canal ou ele não está selecionado em Canais de mensagens. | Uma mensagem não está sendo enviada · Criar uma Conta Connect |
Erro: O destinatário optou por não receber mensagens SMS. ou a variante do WhatsApp. | O Lead/Contato tem a recusa daquele canal marcada. | Campos de recusa de mensagens nos registros |
Erro: O valor do número de telefone de destino deve ser fornecido para mensagens de saída. | O telefone do registro está vazio ou a configuração de objeto aponta para o campo errado. | Uma mensagem não está sendo enviada · Como inserir números de telefone |
| Todo o envio em massa falha porque uma pessoa recusou mensagens. | Um destinatário que recusou mensagens na seleção bloqueia todo o lote. | Acompanhar um envio em massa |
| Uma mensagem agendada saiu imediatamente ao salvar. | Sua Data/hora de agendamento já havia passado; horários passados acionam o envio imediato. | Agendar mensagens |
Uma mensagem agendada ou criada como registro falha: 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 usa um Modelo Connect | Agendar mensagens |
| Falha com erro do provedor de autenticação, autorização ou token expirado. | Os tokens de API salvos estão incorretos ou expiraram. | Atualizar seus tokens de API com segurança |
O cliente recebeu o texto literal {{FirstName}} em vez do nome. | A caixa Campo(s) de mesclagem ficou desmarcada e o corpo foi enviado sem alterações. | Campos de mesclagem |
Enviar algo diferente de texto por SMS falha: 4. Tipo de mensagem não suportado para SMS. | SMS só aceita texto nas duas direções. | O que você pode enviar em cada canal |
Problemas de recebimento
| Sintoma | Causa | Correção |
|---|---|---|
| As mensagens dos clientes não chegam ao Salesforce. | O Site público está inativo, as duas classes de endpoint perderam acesso de convidado ou o webhook não está mais registrado na Meta/Twilio. | Uma mensagem recebida não chegou · Criar o Site público |
| As respostas chegam, mas aparecem só no feed global, sem registro. | O telefone não está salvo no formato exato somente com dígitos ou nenhuma configuração corresponde. | Uma mensagem recebida não chegou · Como inserir números de telefone · Como as mensagens recebidas encontram seu registro |
As marcas de entrega não atualizam: ficam em Enviado, nunca Entregue/Lido. | As confirmações percorrem o mesmo Site/webhook das mensagens recebidas; em SMS, confira também se a URL de status foi salva com a barra final. | Uma mensagem recebida não chegou · Criar o Site público · Conectar os webhooks da Twilio |
| As mensagens recebidas chegam ao registro errado. | A busca encontrou outro registro do número ou a regra de registros relacionados o vinculou onde você não esperava. | Como as mensagens recebidas encontram seu registro · Mensagens por meio de registros relacionados |
| Não é criado um registro novo para números desconhecidos. | Nenhuma configuração está marcada como padrão para novos registros. | Criar registros automaticamente a partir de mensagens recebidas |
Arquivos e mídia
| Sintoma | Causa | Correção |
|---|---|---|
| Imagens não chegam: o texto do WhatsApp aparece, mas a foto nunca aparece. | Falta a configuração de site remoto do servidor da Meta ou a mídia expirou antes do download. | Os arquivos e as imagens não chegam · A configuração de site remoto necessária para arquivos de mídia do WhatsApp |
| O arquivo recebido não tem extensão e não abre corretamente. | O tipo do arquivo não está no mapeamento de tipos. | Os arquivos e as imagens não chegam · Opções de emojis e mapeamentos de tipos de arquivo |
| O cliente enviou uma foto por SMS e nada utilizável chegou. | Mídia recebida por SMS não é compatível; a mensagem fica com status Falhou: Atualmente, o Twilio não oferece suporte a mensagens de mídia de entrada. | Os arquivos e as imagens não chegam |
| Há preocupação sobre quem pode abrir um arquivo enviado pelo WhatsApp. | Os arquivos saem por um link público que qualquer pessoa que o tenha pode abrir. | Enviar arquivos, imagens e vídeos |
Consentimento e recusa de mensagens
| Sintoma | Causa | Correção |
|---|---|---|
| O cliente respondeu STOP, mas continua recebendo mensagens. | Verifique a palavra configurada, o canal e o vínculo com um lead ou contato. Peça ao cliente para enviar a palavra completa sozinha; uma frase como "please stop" não é a resposta prevista | Como funciona a recusa de mensagens |
| O cliente recusou mensagens em uma conversa que não está em um Lead ou Contato. | A recusa automática só atualiza Leads e Contatos; conversas de outros objetos exigem tratamento manual. | Como funciona a recusa de mensagens |
Modelos
| Sintoma | Causa | Correção |
|---|---|---|
O modelo não ativa: O modelo deve ser testado antes da ativação. | Cada modelo deve passar em um teste antes de ser ativado. | Testar e ativar modelos |
Não é possível editar um modelo: Somente modelos inativos podem ser atualizados. Use o botão "Desativar modelo" para desativar o modelo antes de fazer alterações. | Modelos ativos são bloqueados para edição por definição. | Testar e ativar modelos |
| Um modelo que funcionava mostra de repente Teste pendente e inativo. | Um novo teste com falha apaga a marca de teste e desativa o modelo imediatamente. | Testar e ativar modelos |
O envio falha com 5. Erro de modelo: 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. | Campos de mesclagem |
Scripts de chat
| Sintoma | Causa | Correção |
|---|---|---|
O script de chat não começa: Configuração incorreta do modelo de script de chat [Primeira etapa ausente]. | A primeira etapa do modelo de script não está definida corretamente. | Criar um script de chat |
| O script de chat para após a primeira resposta. | A janela da sessão fechou ou Sessão ativa (minutos) ficou vazio no modelo, impedindo o avanço do script. | Sessões de script de chat |
| O script salvou um código confuso em vez do texto do botão tocado. | Respostas de botões e listas interativos guardam o id da opção, não sua etiqueta. Defina os IDs como os valores que deseja armazenar. | Etapas do script de chat |
Feed, acesso e monitoramento
| Sintoma | Causa | Correção |
|---|---|---|
| O feed mostra “Nada no intervalo de tempo atual”. | A mensagem mais recente da conversa é anterior à janela de carregamento do feed. | Configurações de desempenho do feed |
| Erros de “Acesso insuficiente” que indicam um objeto ou campo. | Falta ao usuário um conjunto de permissões do REDA Connect ou ele não tem o adequado. | Dar acesso à sua equipe |
| Não chegam e-mails quando processos em segundo plano falham. | O REDA Connect não envia atualmente esses e-mails automaticamente; configure a rotina de monitoramento. | Receber notificações de erros |
| Você não sabe onde os erros são registrados. | Falhas em segundo plano são salvas na guia Registros Connect. | Ler e trabalhar com os Registros Connect |
Perguntas frequentes
Procure em Mensagem de erro uma frase incluída nas tabelas de Uma mensagem não está sendo enviada. Para falhas em segundo plano, leia Exceção do Registro Connect. Se for um erro do provedor, procure o texto exato na documentação da Meta ou Twilio.
O erro exato copiado, não redigitado; o número da Mensagem Connect ou Registro Connect; o canal; o nome da Conta Connect e quando ocorreu. Esse conjunto normalmente permite resolver na primeira resposta. Contate support@reda.one.
Implemente monitoramento: uma exibição fixada de registros não resolvidos e um relatório assinado. O procedimento completo está em Receber notificações de erros.
Próximos caminhos
- Uma mensagem não está sendo enviada: o guia detalhado do lado do envio.
- Uma mensagem recebida não chegou: o guia detalhado do lado do recebimento.
- Ler e trabalhar com os Registros Connect: onde cada falha em segundo plano é registrada.