Resolver problemas na configuração de canais Meta

Comece pelo sintoma observável. Confira essa conexão, corrija-a e repita o mesmo teste. A jornada de configuração explica a sequência completa; esta página ajuda quando uma etapa não produz o resultado esperado.

Credenciais ou ativos comerciais

Sintoma	Onde conferir	Corrigir e testar novamente
Permissão necessária ausente no diálogo de token	Aplicativo Meta → Use cases → canal correto → Permissions and features; aplicativo selecionado no assistente de token	Adicione/personalize o caso de uso ou resolva seu requisito de acesso e gere o token para esse aplicativo
Página não encontrada ou token da Página rejeitado	Business settings → Accounts → Pages; System User → Assigned assets; permissões do token e ID da Página	Atribua Página/aplicativo corretos e obtenha o token adequado. Salve por Configurar Messenger e Instagram e verifique novamente
App Secret rejeitado ou identidade do aplicativo não confirmada	App ID da Meta na conta e App settings → Basic do mesmo aplicativo	Use o App Secret correspondente, não o segredo do produto com login Instagram. Leia a nota exata; salvar uma credencial não prova sucesso de todas as verificações remotas
Conta Instagram não vinculada ou diferente da armazenada	Conta profissional vinculada à Página, portfólio, permissões do token e acesso à conta	Corrija vínculo/acesso, execute Verificar e salvar novamente e confira o ID da conta Instagram
A conexão funcionava, mas agora as chamadas falham	Expiração/revogação do token e mudanças recentes de acesso ao aplicativo, ativos ou administrador	Siga a substituição de credenciais e repita recebimento e resposta

Nenhuma mensagem recebida no Salesforce

Confirme o destino usado pelo cliente. Compare número, Página ou perfil profissional real usado pelo participante com os IDs da conta do Connect.
Confira a disponibilidade do aplicativo para esse participante. As funções de desenvolvimento Messenger diferem do aviso de publicação WhatsApp. Use as orientações por canal.
No Instagram, confira o caminho. A conta deve ser profissional, vinculada à Página e permitir acesso às mensagens por ferramentas conectadas. Um webhook configurado apenas em Instagram login não é o caminho desta versão.
Leia a lista de configuração. Use Verificar novamente. Confirme callback, assinatura do aplicativo no ativo, conta/canal ativos e linhas de configuração.
Consulte os logs do Connect. Procure Meta Inbound Receipt próximo ao horário do teste. Se houver, leia o resultado para distinguir processamento/correspondência/arquivos de um webhook que nunca chegou.
Repita o mesmo teste após a correção. Para um recebimento Messenger/Instagram retido, Reprocessar webhook da Meta pode tentar novamente. Confirme a mensagem no feed.

Se não existir recebimento, não conclua imediatamente que o mapeamento Salesforce falhou. Confira primeiro entrega Meta e callback. Se existir, use o resultado informado em vez de alterar todas as configurações do aplicativo.

Problemas de validação ou destino do webhook

Verificação falha: confirme endereço HTTPS do Site público ativo, prefixo correto e endpoint de recebimento. Na verificação manual, use o token de verificação da conta, não o token de acesso.
Enviado a outro endereço: identifique a organização que usa o destino. Use Substituir apenas para a mudança de rota desejada; confira a substituição da conta WhatsApp antes de editar o callback compartilhado.
Eventos Instagram rejeitados em Page: use as listas distintas de Page e Instagram. Em particular, messaging_seen é um evento Instagram.
Mensagens chegam, mas confirmações não: confira campos de assinatura correspondentes e a ação do cliente. Não presuma uma confirmação para cada mensagem apenas porque o texto chega.

Mensagem recebida, mas correspondência ou criação incorreta

Abra as linhas ativas de Configuração de conta Connect dessa conta/canal. Confirme Nome de API do objeto, Campo de identidade do canal, prioridade e a linha desejada de Novo registro padrão. Messenger usa o PSID no escopo da Página; Instagram usa seu ID no escopo do canal. Nome de usuário ou ID de Página comercial não corresponde à identidade de um cliente.

Confira os campos obrigatórios e o mapeamento de identidade com {{phone}} em Valores padrão do novo registro. Se a criação for recusada, revise o erro real de validação. Para mapear a conta, informe o nome de API do campo que contém o ID da conta, não o ID em si. Consulte exemplos de Lead e objeto personalizado.

Um nome alternativo de perfil não comprova falha da mensagem. Informações de perfil podem estar indisponíveis mesmo quando mensagens são permitidas. Para novos remetentes, o REDA Connect mantém a identidade e usa o nome/nome de usuário disponível ou a alternativa do canal.

Recebimento funciona, mas a resposta falha

Abra a mensagem que falhou e leia o erro no feed ou nos detalhes.
Em Messenger/Instagram, confirme uma mensagem do cliente dentro da janela atual de 24 horas. Uma mensagem enviada não reabre essa janela; peça ao participante uma nova mensagem de teste.
Confira campo de recusa correspondente, conta/canal ativos, identidade do destinatário e status do token.
Confirme que o tipo é compatível. Esta versão permite respostas de texto Meta e modelos/etapas de roteiro somente de texto; não adiciona envios em massa nem etapas estruturadas/com mídia para Meta.
Corrija o problema específico e envie uma nova resposta de teste acordada. Não reenvie automaticamente uma mensagem de entrega incerta sem conferir o aplicativo do cliente.

Texto funciona, mas falta um arquivo ou ele é rejeitado

Envio: confirme a opção de compartilhamento de documentos, tipo de arquivo do canal e limite de 4,4 MB de Messenger/Instagram. O seletor Instagram aceita JPEG/PNG e PDF. Confira o resultado final, pois o envio de anexos termina de forma assíncrona.
Recebimento: receber o link e armazenar um arquivo Salesforce são etapas distintas. O download ocorre separadamente. Confira o erro do recebimento/arquivo se ele não for armazenado.
Acesso ao host remoto: confirme que as configurações de sites remotos pertinentes do pacote estão ativas na organização. Em atualização por push, o Salesforce entrega configurações recém-adicionadas inativas; o administrador do cliente deve ativá-las. Não desative as configurações do pacote.
Recuperação: após corrigir a causa, use Reprocessar webhook da Meta no recebimento Messenger/Instagram retido para tentar novamente os anexos pendentes; abra o arquivo resultante. Se a URL de origem não existir mais, obtenha um novo anexo de teste acordado.

Um tipo compatível não garante que a Meta aceite todo arquivo individual. Use o erro retornado e um arquivo pequeno comprovadamente válido para distinguir rejeição específica de uma falha geral de conexão.

Uma ação ou canal não aparece

Confira versão instalada, nível do conjunto de permissões existente e layout atribuído ao usuário. Em layout personalizado, adicione Configurar Messenger e Instagram, Configurar WhatsApp ou a ação de reprocessamento conforme apropriado. Após atualizar, confira os valores de canal e suas dependências com Tipo de mensagem/Status. Use a lista de layouts recomendados para localizar e adicionar os campos e ações existentes do pacote.

O que reunir para o suporte

Informe versão instalada, canal, horário/fuso do teste, ativo comercial, comportamento esperado e observado, erro exato e referência do log/mensagem pertinente. Diga se o aplicativo do cliente recebeu a resposta e se outro canal funciona na mesma conta. Isso permite investigar a etapa real que falhou.