🚀 Wati AI ya está aquí – La Capa de Inteligencia Conversacional para Empresas Modernas Explorar🚀 Wati AI ya está aquí →

API de Instagram

API de Instagram: comentarios por REST, MD a través de MCP.

Lee nuevos comentarios, responde en público, envía una respuesta privada y mantén la conversación en los mensajes directos. Diseñado para desarrolladores y creadores. ¿Prefieres WhatsApp? Incluye un enlace a tu número en la respuesta.

  • En la APIComentarios: listar, responder, respuesta privada, permisos

Última actualización el

Qué cubre la API de Instagram hoy

FuncionalidadCómo se usaEstado
Comentarios: listar publicaciones y comentarios, responder en públicoAPI RESTDisponible
Respuesta privada a un comentarioAPI RESTDisponible
MD: enviar y recibirServidor MCPDisponible vía MCP
MDAPI RESTPróximamente, lista de espera

Aún no compatible: ocultar o eliminar comentarios, y eventos de webhooks de Instagram.

  • 16 000+empresas en más de 190 países
  • 4,6/5puntuación media en G2
  • OficialSocio de negocios de Meta y BSP de WhatsApp
Líder en G2, ChatbotsLíder de mercado medio en G2, ChatbotsLíder en impulso en G2, ChatbotsMás implementable en G2, Marketing de WhatsAppISO 27001RGPD

Un comentario. Una conversación más.

Responde en público, responde en privado y sigue hablando en los mensajes directos. O pasa el chat a WhatsApp.

  • Comienza con una plantillaUna plantilla aprobada abre la conversación para un cliente o para 10 000.
  • Continúa en el chatTexto, contenido multimedia y botones una vez que el cliente responde.
  • Termina con tu equipoLos webhooks informan a tu código. La bandeja de entrada del equipo informa a tu personal.
El producto

Enviar. Responder. Obtener respuesta. Transferir.

InstagramComentarios y mensajes directos de Instagram

Crea también automatización para Instagram.

Enumera comentarios en tus publicaciones, responde públicamente o envía una respuesta privada.

Difusiones

Mensajes personales, enviados a gran escala.

Elige una plantilla aprobada y envíala a un máximo de 10.000 destinatarios. Cada persona recibe sus propias variables y cada resultado se devuelve por número.

Mensajería

Responde con algo más que texto.

Dentro de la ventana de 24 horas, envía texto, imágenes, archivos, botones de respuesta y selectores de listas, con un indicador de escritura mientras trabajas.

Actualizaciones y alertas de pedidos

La actualización correcta, en el momento en que ocurre.

Tu tienda, sistema de reservas o de facturación envía una plantilla aprobada cuando algo cambia. Los clientes tocan un botón o responden.

Respuesta automática y chatbots

Tu código responde.

El webhook de mensajes lleva cada nuevo mensaje a tu servidor. Responde con los endpoints de envío o inicia un chatbot de Wati en Pro y Business.

Webhooks

Cada respuesta, en el momento en que llega.

Los webhooks envían nuevos mensajes, confirmaciones de lectura, clics y errores a tu URL. Sin sondeos.

Bandeja de entrada del equipo

El código lo inicia. Las personas lo terminan.

Las respuestas llegan a la bandeja de entrada del equipo de Wati. Asigna un operador, establece el estado y añade etiquetas mediante la API para que la persona adecuada se encargue.

Contactos y segmentos

Tu CRM, reflejado en Wati.

Crea y actualiza contactos con atributos personalizados, y luego visualiza una vista previa de un segmento antes de enviarle un mensaje.

Empieza ahora

En marcha en tres pasos.

  1. Conectar

    Conecta tu número

    Vincula tu número de WhatsApp a través del registro integrado de Meta dentro de Wati.

  2. Autenticar

    Obtén un token

    Crea un token de API en Wati y asígnale únicamente los permisos que necesites. Consérvalo en tu servidor.

  3. Enviar

    Haz tu primera llamada

    Envía una plantilla aprobada con una sola solicitud. Luego, añade un webhook para hacer un seguimiento de la entrega.

Tu primera solicitud, explicada

Esto es lo que incluye una solicitud y dónde aparece cada parte en el mensaje.

  1. Qué comentario

    El comentario que estás respondiendo. Obtienes su ID al listar los comentarios de una publicación.

    comment_iden la ruta de la URL
  2. Desde qué cuenta

    Tu cuenta de Instagram conectada a Wati.

    channel
  3. A quién

    La persona que escribió el comentario, obtenida del mismo comentario.

    userIduserName
  4. Qué enviar

    Texto plano de hasta 1000 caracteres, o una plantilla con botones.

    type = texttexttype = template
  5. Lo que recibes de vuelta

    Un 200 con ok configurado en true significa que la respuesta privada se ha enviado correctamente. Utiliza la misma cabecera Authorization que en cualquier otra llamada.

    ok: trueresult: success

POST /api/ext/v3/comments/{comment_id}/privateReply. El comentario y el texto de la respuesta son ejemplos. Consulta la solicitud en la documentación

Código listo para copiarOcultar el código
POST/api/ext/v3/comments/{comment_id}/privateReply
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "yourbrand",
    "userId": "17841400000000000",
    "userName": "maya",
    "type": "text",
    "text": "Hola Maya, sí tenemos. Chatea con nosotros en WhatsApp para ver las opciones de envío."
  }'
200 Respuesta de ejemploEstructura de la respuesta según el esquema de la documentación
{  "ok": true,  "result": "success"}
Integrado

Lo que Wati gestiona para que tú no tengas que hacerlo.

Incorporación de números

Conéctate a través del Registro Integrado de Meta. La cuenta de WhatsApp Business se registra a nombre de tu empresa.

Estado de las plantillas

Los cambios de aprobación, calidad y categoría llegan como webhooks, para que lo sepas antes de que un envío falle.

Reintentos de webhooks

Hasta 144 reintentos, cada 10 minutos. Si tu endpoint sigue fallando, Wati te envía un correo electrónico.

Límites de velocidad y colas

Si vas demasiado rápido, obtienes un error 429 con una cabecera Retry-After. Los mensajes aceptados esperan en una cola.

Transferencia a humanos

Una bandeja de entrada compartida para el equipo para aquellas conversaciones que tu código no deba responder en solitario.

Tokens de API con ámbito

La versión v3 admite tokens con ámbito, de modo que cada integración obtiene únicamente el acceso que necesita.

Envios programados

Programa el envío de una plantilla para más tarde con una sola llamada. Wati la envía a tiempo.

Estimación de costes previa

Calcula el coste de una difusión antes de enviar nada.

Bajo el capó

Los endpoints, por capacidad.

Plantillas

Inicia conversaciones con plantillas aprobadas, ahora o de forma programada.

Docs →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Difusiones

Lee los resultados de las campañas y el estado por destinatario, y calcula el coste primero.

Docs →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

Mensajería

Responde con texto, contenido multimedia o botones dentro de la ventana de 24 horas.

Docs →
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

Chatbots Pro+

Haz una lista de tus chatbots de Wati e inicia uno para un contacto.

Docs →
GET/chatbotsPOST/chatbots/start

Webhooks

Gestiona las suscripciones y lista los tipos de eventos que puedes recibir.

Docs →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

Contactos y segmentos

Sincroniza contactos y atributos desde tu CRM y luego segmenta el público.

Docs →
POST/contactsPUT/contactsPOST/segments/evaluate

Bandeja de entrada del equipo

Asigna un operador, cambia el estado, añade o elimina etiquetas.

Docs →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

Lista publicaciones y comentarios, responde en público o en privado, y comprueba los permisos.

Docs →
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

Las rutas son relativas a https://live-mt-server.wati.io/api/ext/v3. La creación de un webhook utiliza la ruta heredada POST /{tenantId}/api/v2/webhookEndpoints.

Para agentes de IA, el servidor Wati MCP cubre las mismas acciones de WhatsApp y puede responder a mensajes directos de Instagram y chats de Messenger con texto.

Ver los 19 tipos de eventos de webhook de WhatsApp

Mensajes

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

Estado de entrega

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

Plantillas y cuenta

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

Participación y llamadas

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

También hay disponibles versiones BSUID de varios eventos. Documentación de webhooks

Límites y planes

Límites claros. Publicados.

30 a 100 por 10 s

Envíos de plantillas

Llamadas para enviar plantillas, según tu plan (Growth, Pro o Business).

10 000 destinatarios

Por llamada de envío de v3

Una plantilla, hasta 10 000 personas, cada una con sus propias variables.

24 h de ventana

Respuestas de formato libre

El texto, contenido multimedia y botones necesitan una ventana de servicio de atención al cliente abierta. Fuera de ella, envía una plantilla.

429 Retry-After

Cuando vas demasiado rápido

Wati te indica cuánto tiempo debes esperar. Los mensajes aceptados se procesan en una cola.

Límites de velocidad y disponibilidad de planes en detalle
Límites de velocidad documentados por plan
EndpointGrowthProBusiness
/addContact, /getContacts10 / 10 s10 / 10 s10 / 10 s
/getMessages10 / 10 s10 / 10 s10 / 10 s
/sendTemplateMessage30 / 10 s60 / 10 s100 / 10 s
/sendTemplateMessages30 / 10 s60 / 10 s100 / 10 s

Límites publicados en Errores y límites de velocidad, organizados por nombre de endpoint. La llamada masiva de la versión v1 admite hasta 1000 contactos. Los endpoints principales de mensajería, plantillas y contactos están incluidos en todos los planes. La asignación de equipos, el estado del chat, los chatbots y los segmentos personalizados requieren los planes Pro o Business. La actualización de atributos para muchos contactos a la vez requiere Business. Disponibilidad de endpoints por plan. Si necesitas límites más altos, habla con Wati sobre tu caso de uso.

Preguntas frecuentes

Preguntas frecuentes

La referencia completa de la API es pública. Leer la documentación

¿Qué puede hacer la API de Instagram de Wati?

Hoy en día, la API lista tus publicaciones de Instagram y sus comentarios, devuelve el recuento de comentarios no leídos, responde a comentarios de forma pública, envía una respuesta privada al autor del comentario y verifica los permisos de comentarios de tu cuenta. Las respuestas públicas pueden tener hasta 2,200 caracteres y las respuestas de texto privadas hasta 1,000.

¿Puedo crear automatizaciones para Instagram sin un gran equipo de ingeniería?

Sí. Los endpoints de comentarios son llamadas REST simples con un token de autenticación (bearer token), por lo que un creador de aplicaciones de IA puede escribirlos a partir de una descripción breve. Una buena primera construcción: buscar nuevos comentarios, responder públicamente y luego enviar una respuesta privada. Si ya usas un agente de IA, el servidor MCP de Wati puede responder a los mensajes directos (DMs) de Instagram con texto.

¿Cómo verifico mis permisos de Instagram antes de responder?

Llama a GET /channels/{channel}/permissions con tu canal de Instagram conectado. La respuesta te indica si se han concedido los permisos de comentarios y enumera los alcances faltantes, para que tu automatización pueda detenerse antes de que falle una respuesta.

¿Necesito saber programar?

Menos que antes. Los creadores de aplicaciones de IA pueden escribir las llamadas a la API a partir de instrucciones en lenguaje sencillo, y los ejemplos de esta página muestran cada llamada.

Aún necesitas un número de WhatsApp conectado a Wati, un token de API y una plantilla aprobada por Meta antes de poder iniciar una conversación. Si una herramienta de IA escribe el código, verifica que tu token permanezca en el servidor.

¿Cuáles son los límites de velocidad (rate limits) de la API?

Las llamadas de contactos y de historial de mensajes están limitadas a 10 solicitudes por cada 10 segundos en todos los planes. Los envíos de plantillas están limitados a 30, 60 o 100 solicitudes por cada 10 segundos en los planes Growth, Pro y Business. Cuando alcances un límite, recibirás un error HTTP 429 con un encabezado Retry-After. Para límites más altos, contacta a Wati.

¿Puedo enviarle un mensaje a un cliente en cualquier momento?

En WhatsApp, el texto de formato libre, los archivos multimedia y los mensajes interactivos requieren una ventana abierta de atención al cliente de 24 horas. Fuera de esa ventana, inicia la conversación con una plantilla aprobada por Meta.

¿Cuál es la diferencia entre la aplicación WhatsApp Business y la API?

La aplicación Business está diseñada para chats manuales en un teléfono, con hasta 5 dispositivos vinculados y listas de difusión limitadas a 256 contactos. La API conecta WhatsApp a tus propios sistemas. Puedes enviar plantillas aprobadas a escala, automatizar respuestas, recibir webhooks y compartir un solo número en una bandeja de entrada para equipos.

¿Qué endpoints incluye mi plan?

Los endpoints principales de mensajería, plantillas y contactos están incluidos en todos los planes. La asignación de equipos, el estado de los chats, los chatbots y los segmentos personalizados requieren los planes Pro o Business. La documentación enumera la disponibilidad de los endpoints según el plan.

Tu primer mensaje está a solo una solicitud de distancia.

Comienza gratis, conecta tu número de WhatsApp en Wati y realiza tu primera llamada.