Conectar Meta: WhatsApp e Instagram — Manual del operador | AI Agent Builder

Conectar Meta: WhatsApp e Instagram

Paso a paso para conectar un número de WhatsApp y una cuenta de Instagram directo con Meta: qué crear en Meta, qué dato va en cada campo, cómo verificar el webhook y qué hacer cuando no llegan mensajes.

8 min de lectura · Actualizado 13 de noviembre de 2026

Esta guía conecta el WhatsApp y el Instagram de Clínica del Sol directo con Meta, sin intermediarios. Si la clínica usa Twilio para WhatsApp, la configuración es otra: el número se conecta en la integración Twilio y el agente lo decide la URL del webhook (Conectar Twilio).

Los pasos del lado de Meta están descritos según la consola de Meta al momento de escribir esta guía; Meta cambia nombres y menús con frecuencia. Lo que dice del lado de la plataforma está verificado contra el código.

Antes de empezar

  • Un número y una cuenta por tenant. Cada tenant tiene una sola configuración de WhatsApp directo y una de Instagram, y cada una atiende con un solo agente. Si la clínica necesita dos números, hacen falta dos tenants.
  • El tenant necesita WhatsApp o Instagram habilitado en sus funcionalidades (capítulo 8).
  • Un administrador del Business Manager de la clínica, o alguien con permisos sobre su cuenta de WhatsApp Business y su página.
  • Una sola app de Meta puede servir para los dos canales. Si WhatsApp e Instagram están en la misma app, usá el mismo secreto de la app en ambas pestañas.

La configuración está en Integraciones → Meta Business, con tres pestañas: Meta (el estado de los dos canales), WhatsApp e Instagram.

WhatsApp

1. Lo que hay que preparar en Meta

  1. En Meta for Developers, creá una app de tipo empresa y agregale el producto WhatsApp.
  2. En WhatsApp → Configuración de la API, anotá el ID de la cuenta de WhatsApp Business y el ID del número de teléfono. Es el identificador del número, no el número en sí.
  3. En la configuración del negocio, creá un usuario del sistema con rol de administrador, asignale la app y la cuenta de WhatsApp Business, y generá un token con los permisos whatsapp_business_messaging y whatsapp_business_management. Usá un token sin vencimiento: un token temporal de la consola deja de funcionar en horas.
  4. En la configuración básica de la app, anotá el ID de la app y el secreto de la app.

2. Lo que va en cada campo

En la pestaña WhatsApp:

CampoQué va
ID de la app de MetaEl ID de la app (paso 4)
ID de la cuenta de WhatsApp BusinessPaso 2
ID del número de teléfonoPaso 2
AgenteEl agente que atiende el número, por ejemplo Turnos y consultas
Token de usuario del sistemaEl token del paso 3
Secreto de la app de MetaEl secreto del paso 4

Guardá. Al guardar por primera vez, la plataforma:

  • Cifra el token y el secreto. Después no se vuelven a mostrar: si dejás esos campos vacíos en un guardado posterior, se conservan los anteriores.
  • Genera el token de verificación del webhook y lo muestra en la pantalla, junto con la URL del webhook del agente elegido.
URL y token de verificación del webhook que muestra Meta Business al guardar
URL y token de verificación del webhook que muestra Meta Business al guardar

3. Habilitar y verificar el webhook

El orden importa: primero habilitá el canal, después verificá en Meta. Mientras el canal está deshabilitado, la plataforma no responde la verificación y Meta muestra un error.

  1. Activá Habilitar el canal directo de WhatsApp y guardá. El interruptor solo se habilita cuando el token y el secreto están cargados.
  2. En Meta, en WhatsApp → Configuración, pegá la URL del webhook y el token de verificación que muestra la plataforma, y verificá.
  3. En los campos del webhook, suscribite a messages. Si no lo hacés, la verificación funciona igual pero no llega ningún mensaje.

La URL tiene esta forma: {URL de la API}/webhook/whatsapp-cloud/{tenant}/{agente}. Como lleva la clave del agente, si cambiás el agente, cambia la URL y hay que actualizarla en Meta.

4. Probar

Mandá un mensaje de texto al número desde un teléfono. La conversación aparece en Monitoreo → Sesiones, filtrando por WhatsApp. Si no aparece, mirá la tabla del final.

Cómo se comporta

  • Cualquier persona puede escribir. No hay lista de números permitidos.
  • Una conversación por persona y número, que se renueva después de 24 horas sin mensajes (capítulo 6).
  • Solo texto y botones. Mensajes de texto, respuestas a botones y a listas. Audios, imágenes, documentos, ubicaciones y reacciones se descartan sin respuesta.
  • Respuestas largas se dividen en mensajes de hasta 4.000 caracteres.
  • Preguntas con opciones. Cuando el workflow pide una elección (un paso de aprobación, capítulo 3), hasta 3 opciones se muestran como botones y de 4 a 10 como lista. Si la persona escribe en lugar de elegir, la pregunta se repite.
  • La ventana de 24 horas. Meta solo permite escribirle libremente a alguien dentro de las 24 horas de su último mensaje. Las respuestas del agente siempre están dentro de esa ventana; un mensaje que el workflow quiera mandar más tarde es rechazado.
  • Reintentos de Meta. La plataforma procesa cada mensaje y recién después le confirma la recepción a Meta. Si algo falla, Meta lo reenvía, y la plataforma retoma sin repetir lo que ya mandó.

Instagram

1. Lo que hay que preparar en Meta

  1. La cuenta de Instagram de la clínica tiene que ser profesional y estar vinculada a una página de Facebook.
  2. En la app de Meta, agregá los productos de mensajería para Instagram.
  3. Generá un token de acceso de la página con los permisos instagram_basic, instagram_manage_messages y pages_messaging. Para responder comentarios, Meta exige además el permiso de gestión de comentarios.
  4. Anotá el ID de la cuenta profesional de Instagram y el secreto de la app.

2. Lo que va en cada campo

En la pestaña Instagram:

CampoQué va
ID de la página de Facebook vinculadaEl ID de la cuenta profesional de Instagram (ver la advertencia)
AgenteEl agente que atiende
Token de acceso de la páginaEl token del paso 3
Secreto de la app de MetaEl mismo secreto que en WhatsApp, si es la misma app

Atención con el primer campo. La plataforma compara ese valor con el identificador que Meta manda en cada evento de Instagram, y Meta manda el de la cuenta de Instagram, no el de la página. Si cargás el ID de la página, la verificación del webhook funciona, pero todos los mensajes se rechazan. Si después de la prueba no aparece nada, revisá este campo primero.

3. Habilitar, verificar y probar

  1. Activá Activar canal de Instagram y guardá. La pantalla muestra la URL y el token de verificación, igual que en WhatsApp.
  2. En la configuración de webhooks de Instagram en Meta, pegá la URL y el token, verificá y suscribite a messages y, si querés que responda comentarios, a comments.
  3. Mandá un mensaje directo a la cuenta desde otra cuenta de Instagram.

Cómo se comporta

  • Mensajes directos y comentarios. Responde los mensajes directos y contesta los comentarios en las publicaciones. Cada publicación es una conversación aparte para cada persona.
  • Idioma. Responde en el idioma por defecto del tenant.
  • Solo texto. Los mensajes sin texto —imágenes, audios, respuestas a historias— se descartan.
  • Formato. Se quita el formato; los mensajes directos se dividen en partes de 1.000 caracteres y las respuestas a comentarios se cortan en 2.200.

Cuando no llegan mensajes

SíntomaCausa probableQué hacer
Meta no puede verificar la URLEl canal está deshabilitado, o la URL es de otro agenteHabilitá el canal y copiá de nuevo la URL desde la pantalla
Meta dice que el token no coincideSe copió mal el token de verificaciónCopialo de nuevo desde la pantalla
La URL verifica, pero no llega nada (WhatsApp)No hay suscripción a messages, o el ID del número no coincideRevisá los campos del webhook en Meta y el ID del número
La URL verifica, pero no llega nada (Instagram)El primer campo tiene el ID de la páginaCargá el ID de la cuenta profesional de Instagram
Llegan, pero el agente no respondeToken vencido o sin permisos, o el número no está habilitado en MetaGenerá un token permanente del usuario del sistema con los permisos indicados
La persona mandó un audio o una foto y no hubo respuestaSolo se procesan textos y botonesEs el comportamiento esperado
Después de cambiar el agente dejó de funcionarLa URL lleva la clave del agenteActualizá la URL en Meta

Dónde termina

  • Un número de WhatsApp y una cuenta de Instagram por tenant, cada uno con un solo agente.
  • No hay botón para probar la conexión: se prueba mandando un mensaje.
  • No se procesan audios, imágenes ni documentos en ninguno de los dos canales.
  • No hay plantillas de WhatsApp desde el admin. La plataforma sabe enviar plantillas aprobadas, pero hoy no hay forma de configurarlo en el editor; sin plantillas no se le puede escribir a alguien fuera de la ventana de 24 horas.
  • No se informan las confirmaciones de entrega y lectura, ni se muestra "escribiendo".
  • El ID de la app se guarda pero no se usa.
  • En Instagram, la protección contra mensajes repetidos es por servidor: con varias instancias, un reenvío de Meta podría responderse dos veces.

Para revisar

  • El token de WhatsApp es de un usuario del sistema y no vence.
  • El webhook de WhatsApp está suscripto a messages; el de Instagram, a messages y, si corresponde, a comments.
  • La URL configurada en Meta es la que muestra hoy la pantalla, con el agente actual.
  • En Instagram, el primer campo tiene el ID de la cuenta profesional de Instagram.
  • Un mensaje de prueba aparece en Sesiones.