Descripción general de la Messages API

La Messaging API te permite gestionar los mensajes directos (DM) con los interlocutores que contactan a tus User Profiles. Un interlocutor es la persona con la que tu usuario (User Profile) está comunicándose. Una conversación es una serie de mensajes entre tu usuario (User Profile) y su interlocutor.

• La Messaging API está incluida en todos los Business Plans de Ayrshare y como complemento de pago para los planes Premium.
• Tanto para los planes Business como Premium, debes activar la mensajería en la página Account del dashboard de Ayrshare.
• La mensajería está disponible para Facebook Messenger, Instagram Direct Messenger, X Direct Messages y WhatsApp (Private Beta).

​

Características principales de la mensajería

• Gestionar las conversaciones de tus usuarios con sus interlocutores.
• Enviar mensajes de texto, imagen, video y emoji en nombre de tus usuarios.
• Recuperar el historial completo de conversaciones.
• Configurar respuestas automáticas de mensajes.
• Recibir actualizaciones en tiempo real mediante webhooks sobre mensajes recibidos, reacciones a mensajes y confirmaciones de lectura.

​

Habilitar la mensajería

​

Habilitar tu cuenta de Ayrshare y tus User Profiles

Primero debes habilitar la mensajería en tu cuenta general de Ayrshare para gestionar los DMs. En el dashboard de Ayrshare, ve a la página Account, haz clic en el botón “Learn More” y luego en “Enable”. En este punto has habilitado la mensajería para tu cuenta general, pero no la has activado para cada User Profile individual. Puedes activar la mensajería para User Profiles individuales, ya sea en la página User Profiles marcando la casilla “Messaging Active” para cada perfil, o utilizando el endpoint de creación o actualización profiles. Después de habilitar la mensajería para un User Profile, debes volver a vincular la cuenta social (Facebook e Instagram) en la página Social Accounts/Social Linking. Una vez habilitada, verás la insignia “Messaging” en la cuenta social vinculada.

​

Habilitar la mensajería para WhatsApp

Vincula una cuenta de WhatsApp Business a través del flujo embedded signup de Meta directamente desde el dashboard de Ayrshare:

• Necesitas una cuenta de Meta Business Manager, una WhatsApp Business Account (WABA) y un número de teléfono elegible. Meta verifica la cuenta y el número de teléfono durante el embedded signup.
• En la página Social Accounts, haz clic en Link en la tarjeta de WhatsApp. Ayrshare abrirá el pop-up de embedded signup de Meta, que guía al cliente para seleccionar o crear su Business Manager, su WABA y su número de teléfono, así como para aceptar los términos de Meta.
• Cuando finaliza el signup, Ayrshare verifica la propiedad de la WABA y del número de teléfono seleccionados, completa el registro y suscribe la cuenta a los webhooks de WhatsApp. No es necesario introducir un PIN de registro por separado en el dashboard de Ayrshare.

​

Comportamiento específico importante de WhatsApp

• Los destinatarios son números de teléfono, no IDs. WhatsApp identifica a los interlocutores mediante el número de teléfono en formato E.164 (solo dígitos, sin +). Los conversation IDs devueltos por Ayrshare también son el número de teléfono del interlocutor — no existen conversation IDs opacos como los que usan Facebook e Instagram.
• Ventana de atención al cliente de 24 horas. WhatsApp Business solo permite enviar mensajes salientes en formato libre dentro de las 24 horas posteriores al último mensaje del interlocutor. Fuera de esa ventana, Meta rechaza el envío. Los mensajes con plantilla fuera de la ventana de 24 horas no están soportados actualmente a través de Ayrshare.
• Dirígete directamente a un destinatario con la API. Envía el número de teléfono del destinatario a Send Message. Meta solo entrega un mensaje en formato libre cuando ese destinatario está dentro de la ventana de atención al cliente de 24 horas. Para contactos en frío se requieren plantillas aprobadas, y Ayrshare no expone actualmente el envío de plantillas.
• El estado de entrega usa un solo campo. Cuando está disponible en un mensaje saliente almacenado, Get Messages devuelve status como sent, delivered, read o failed. Las actualizaciones de estado de entrega y las reacciones de WhatsApp no se envían actualmente a tu URL de webhook registrada.
• Los tipos y tamaños de medios siguen los límites publicados por Meta para la WhatsApp Cloud API: imágenes hasta 5 MB, audio y video hasta 16 MB, y documentos hasta 100 MB en el momento de redactar esto.

​

Medios de WhatsApp admitidos

• Imagen: .jpg, .jpeg, .png
• Video: .mp4, .3gp
• Audio: .aac, .amr, .mp3, .m4a, .ogg
• Documento: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​

Habilitar la mensajería en la app de Instagram

Puede que tengas que habilitar la mensajería en tu cuenta de Instagram:

• Ve a tu perfil en la app móvil de Instagram y toca el icono de menú ≡ en la esquina superior derecha para ir a la página Settings and activity.
• Desplázate hasta la sección How others can interact with you.
• Toca Messages and story replies.
• Toca Message requests.
• En Connected tool, activa el interruptor Allow access to messages.

​

Información importante sobre la mensajería

​

Recuperación del historial de mensajes para Facebook e Instagram

Cuando habilitas la mensajería por primera vez para un perfil de usuario con Facebook o Instagram vinculado, existen limitaciones importantes al acceder al historial de conversaciones:

​

Limitaciones de la conexión inicial

• Facebook e Instagram solo permiten recuperar los últimos 20 mensajes de las conversaciones existentes al vincular una cuenta por primera vez para mensajería.
• Si una conversación tiene más de 20 mensajes, solo los 20 más recientes serán accesibles inicialmente.

​

Después de la configuración inicial

• Una vez habilitada la mensajería, todos los nuevos mensajes enviados y recibidos serán totalmente accesibles.
• Ayrshare mantiene el historial completo de las conversaciones a partir de ese momento.
• Por ejemplo: si inicialmente recuperas 20 mensajes y luego se intercambian 100 mensajes nuevos, podrás acceder a los 120 mensajes en total.

Esta limitación solo se aplica a los mensajes históricos que existían antes de habilitar la mensajería: toda la actividad de conversación futura de Facebook e Instagram se conservará y será totalmente accesible.

​

Límite de conversaciones y precios

• Cada User Profile de Ayrshare puede tener hasta 1,000 conversaciones activas por ciclo de facturación. El conteo de conversaciones activas es la suma de todas las redes sociales.
• Plan Premium: la mensajería es un complemento fijo de $49 al mes por cuenta.
• Planes Launch y Business: la mensajería se factura a $0.09 por conversación activa mediante la facturación medida de Stripe. Hay descuentos por volumen disponibles; ponte en contacto con tu representante de cuenta de Ayrshare para obtener más detalles.
• Una conversación se cuenta como activa en el ciclo de facturación cuando envías un mensaje a un destinatario. Los mensajes entrantes de un destinatario, por sí solos, no marcan una conversación como activa.
• Si se ha alcanzado el límite de 1,000 conversaciones, aún puedes recibir mensajes, pero no podrás responder hasta el inicio del siguiente ciclo de facturación.
• El número de mensajes, enviados o recibidos, en una conversación activa es ilimitado.
• Si necesitas aumentar el límite de conversaciones, ponte en contacto con tu representante de cuenta de Ayrshare.

Puedes ver el conteo actual de conversaciones con el endpoint user.

​

Problemas de control de la mensajería en Facebook e Instagram

Meta (Facebook e Instagram) utiliza un sistema de “control de hilo” (thread control) para las conversaciones de mensajería. Esto significa que solo una app puede enviar mensajes en una conversación a la vez, mientras que las demás apps solo pueden recibir mensajes.

​

¿Qué significa esto?

Si ves el error “Message failed to send because another app is controlling this thread now”, significa que:

• Otra app de terceros controla actualmente esa conversación.
• Ayrshare solo puede recibir mensajes en esa conversación.
• Ayrshare no puede enviar mensajes hasta que recupere el control.

​

Cómo solucionar este problema

Para que Ayrshare pueda enviar mensajes de nuevo, debes eliminar la app de terceros que está controlando la conversación. Ten en cuenta que Meta (Facebook e Instagram) puede actualizar el proceso para eliminar apps de terceros, así que utiliza los siguientes pasos como una guía general. Para Facebook Pages:

1. Ve a Facebook.com e inicia sesión en tu cuenta.
2. Haz clic en el menú (☰) en la esquina superior derecha → Settings & Privacy → Settings.
3. En la barra lateral izquierda, haz clic en Apps and Websites.
4. Encuentra la app de terceros que está controlando tu mensajería.
5. Haz clic en Remove junto a esa app.
6. Confirma la eliminación.

Para cuentas de Instagram Business:

1. Abre la app de Instagram en tu teléfono.
2. Ve a tu Profile → toca el menú (☰) → Settings and Privacy.
3. Toca Apps and Websites.
4. Encuentra y elimina la app de terceros.

Alternativa para Instagram:

1. Ve a business.facebook.com.
2. Navega a Business Settings.
3. En Accounts, haz clic en Instagram Accounts.
4. Selecciona tu cuenta de Instagram.
5. Comprueba las apps conectadas y elimina la que causa el problema.

​

Después de la eliminación

Una vez que hayas eliminado la app de terceros:

• El control del hilo volverá automáticamente a Ayrshare.
• Deberías poder enviar mensajes con normalidad de nuevo.
• No se requiere ninguna otra acción por tu parte.

Si sigues teniendo problemas después de eliminar la app, ponte en contacto con nuestro equipo de soporte.

​

Webhooks de mensajes

Consulta Messages Webhooks para recibir automáticamente mensajes, confirmaciones de lectura o reacciones.