Solucionar problemas de configuración de los canales Meta

Comience por el síntoma observado. Compruebe esa conexión concreta, corríjala y repita la misma prueba. La guía de configuración explica la secuencia completa; esta página ayuda cuando un paso no produce el resultado esperado.

Credenciales o activos empresariales

Síntoma	Dónde revisar	Corrección y nueva prueba
Falta un permiso necesario en el diálogo de tokens	App de Meta → Use cases → canal correcto → Permissions and features; confirme la app seleccionada en el asistente de token.	Añada o personalice el caso de uso necesario o resuelva su requisito de acceso; después genere el token para esa app.
No se encuentra la página o se rechaza su token	Business settings → Accounts → Pages; usuario del sistema → Assigned assets; permisos del token e ID de página	Asigne la página y app correctas y obtenga el token adecuado. Guárdelo mediante Configurar Messenger e Instagram y utilice Volver a comprobar.
Se rechaza App Secret o no se confirma la identidad de la app	ID de la app Meta de la cuenta y App settings → Basic de esa app	Utilice el secreto correspondiente de la app de Meta, no el del producto con inicio de sesión de Instagram. Lea la nota exacta: guardar una credencial no demuestra que todas las comprobaciones remotas hayan sido correctas.
Instagram no está vinculado o es distinto de la cuenta almacenada	Cuenta profesional vinculada a la página, portfolio, permisos del token y acceso a la cuenta	Corrija la asociación o el acceso, ejecute Verificar y guardar y compruebe ID de la cuenta de Instagram.
Antes funcionaba, pero ahora fallan las llamadas	Vencimiento o revocación del token y cambios recientes de acceso a app, activos o administrador	Siga la sustitución de credenciales y repita entrada y respuesta.

No aparece el mensaje entrante en Salesforce

Confirme el destino del cliente. Compare el número empresarial, la página o el perfil profesional utilizado con los ID de la cuenta Connect.
Compruebe la disponibilidad de la app para ese participante. Los roles de desarrollo de Messenger y la advertencia de publicación de WhatsApp son diferentes. Consulte las indicaciones por canal.
Para Instagram, compruebe la ruta. La cuenta debe ser profesional, estar vinculada a la página y permitir a las herramientas conectadas acceder a los mensajes. Un webhook configurado únicamente bajo Instagram login es la ruta incorrecta para esta versión.
Lea la lista de configuración. Utilice Volver a comprobar. Confirme la dirección prevista, la suscripción de la app al activo, la cuenta y el canal activos y las filas de configuración.
Revise los registros de Connect. Busque un registro de recepción entrante de Meta alrededor de la hora de prueba. Si existe, examine el resultado para distinguir el procesamiento, la asociación o los archivos de un webhook que nunca llegó.
Repita la misma prueba después de corregir. Para un evento de Messenger o Instagram conservado, Volver a procesar webhook de Meta permite intentar de nuevo su procesamiento. Confirme el mensaje en Connect Feed.

Si no existe un registro de recepción, no concluya de inmediato que falló la asociación de registros en Salesforce. Revise primero la entrega de Meta y la dirección del webhook. Si existe, utilice su resultado en lugar de cambiar todos los ajustes de la app.

Problemas de verificación o destino del webhook

Falla la verificación: confirme que la dirección sea la del sitio público HTTPS activo, con el prefijo y la ruta entrante correctos. Para verificación manual, utilice Token de verificación de cuenta Connect, no el token de acceso.
Se envía a otra dirección: identifique qué organización utiliza ese destino. Elija Reemplazar únicamente para el cambio previsto; revise la dirección específica de la cuenta de WhatsApp antes de editar la dirección compartida de la app.
Se rechazan eventos de Instagram en Page: utilice las listas distintas de eventos de Page e Instagram. En particular, messaging_seen pertenece a Instagram.
Llegan mensajes, pero no estados de entrega o lectura: revise los campos suscritos y la acción del cliente. El éxito del texto no significa que exista un evento de estado para cada mensaje.

Llega el mensaje, pero la asociación o creación del registro es incorrecta

Abra las filas activas de Configuración de cuenta Connect de la cuenta y del canal. Confirme Nombre de API del objeto, Campo de identidad del canal, la prioridad y la fila prevista de Nuevo registro predeterminado. Messenger utiliza el campo PSID del remitente; Instagram, su ID de ámbito específico. Un nombre de usuario o ID de página empresarial no coincide con la identidad del cliente.

Compruebe los campos obligatorios y la asignación de identidad con {{phone}} en Valores predeterminados nuevo registro. Si se rechaza la creación, revise el error real de validación. En una asignación de cuenta, introduzca el nombre de API del campo que contiene el ID de cuenta Connect, no el ID mismo. Consulte los ejemplos de candidato y objeto personalizado.

Un nombre alternativo de perfil no demuestra que haya fallado el mensaje. La información del perfil puede no estar disponible aunque se permita la mensajería. Para nuevos remitentes, REDA Connect conserva la identidad y utiliza el nombre, el usuario o el valor alternativo del canal disponible.

Funcionan los mensajes entrantes, pero falla la respuesta

Abra el mensaje fallido y lea el error de Connect Feed o de sus detalles.
Para Messenger o Instagram, confirme que el cliente haya escrito dentro de la ventana actual de 24 horas. Un mensaje saliente no la reabre; solicite al participante que inicie una nueva prueba.
Compruebe la preferencia de exclusión voluntaria correspondiente, la cuenta y el canal activos, la identidad del destinatario y el estado del token.
Confirme que el tipo de mensaje sea compatible. Esta versión permite texto y plantillas o pasos de guion de solo texto para Meta; no añade envíos masivos ni pasos estructurados o multimedia.
Corrija el problema concreto y envíe otra respuesta de prueba acordada. Si la entrega real es incierta, compruebe la app del cliente antes de reenviar automáticamente.

Funciona el texto, pero falta un archivo o se rechaza

Saliente: confirme Permitir uso compartido de documentos, el tipo de archivo del canal y el límite de 4,4 MB para Messenger e Instagram. El selector de Instagram admite JPEG/PNG y PDF. Compruebe el resultado final, porque los adjuntos se envían de forma asíncrona.
Entrante: recibir un enlace y guardar un archivo en Salesforce son etapas diferentes. La descarga se realiza por separado. Si el archivo no se guarda, revise el error del evento o del archivo.
Acceso al servidor remoto: confirme que los sitios remotos del paquete correspondientes estén activos en esta organización. En una actualización automática, Salesforce entrega los sitios nuevos inactivos; el administrador suscriptor debe activarlos. No desactive los sitios incluidos en el paquete.
Recuperación: tras resolver la causa, utilice Volver a procesar webhook de Meta en el evento conservado de Messenger o Instagram para reintentar el trabajo de adjuntos incompleto y abra el archivo resultante. Si la URL de origen ya no está disponible, obtenga otro adjunto de prueba acordado.

Un tipo compatible no garantiza que Meta acepte todos los archivos. Utilice el error devuelto y un archivo pequeño que sepa que funciona para distinguir un rechazo específico de un problema general de conexión.

Falta una acción o un canal

Compruebe la versión instalada, el nivel de permisos existente del usuario y el formato de página asignado. En un formato personalizado, añada Configurar Messenger e Instagram, Configurar WhatsApp o la acción de reprocesamiento según corresponda. Revise los valores de canal y sus dependencias de tipo de mensaje y estado después de actualizar. Utilice la lista de formatos recomendados para localizar y añadir los campos y acciones existentes del paquete.

Qué recopilar para soporte

Proporcione la versión instalada, el canal, la hora y zona horaria, el activo empresarial, el comportamiento esperado y observado, el error exacto y la referencia del registro o mensaje de Connect. Indique si el cliente recibió la respuesta y si otro canal funciona con la misma cuenta. Así se puede investigar el paso concreto que falló.