Saltar al contenido principal
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 y X Direct Messages.

Más información sobre la Messaging API

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. Messaging badge

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

Una conversación debe ser iniciada por el interlocutor. Una vez establecida la conversación, puedes enviar mensajes libremente, recibirlos, obtener reacciones (p. ej., “me gusta”) o confirmaciones de lectura en nombre de tus usuarios.
Tu usuario debe responder a una conversación de Instagram dentro de los 7 días posteriores al último mensaje enviado por el interlocutor. Si el interlocutor no ha enviado un mensaje en 7 días, la conversación se considera inactiva y no se puede responder.

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 & PrivacySettings.
  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.