> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general de la Messages API

> Envía y recibe mensajes directos en Facebook, Instagram y X/Twitter

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["business"]} maxPackRequired={false} />

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.

<ul class="custom-bullets">
  <li>
    La Messaging API está incluida en todos los Business Plans de Ayrshare y como
    complemento de pago para los planes Premium.
  </li>

  <li>
    Tanto para los planes Business como Premium, debes activar la mensajería en la
    página Account del dashboard de Ayrshare.
  </li>

  <li>
    La mensajería está disponible para Facebook Messenger, Instagram Direct Messenger
    y X Direct Messages.
  </li>
</ul>

<Card title="Más información sobre la Messaging API" icon="link" href="https://www.ayrshare.com/ayrshare-messaging-api-for-facebook-instagram-and-x-twitter/" horizontal />

## Características principales de la mensajería

<ul class="custom-bullets">
  <li>Gestionar las conversaciones de tus usuarios con sus interlocutores.</li>

  <li>
    Enviar mensajes de texto, imagen, video y emoji en nombre de tus usuarios.
  </li>

  <li>Recuperar el historial completo de conversaciones.</li>
  <li>Configurar respuestas automáticas de mensajes.</li>

  <li>
    Recibir actualizaciones en tiempo real mediante webhooks sobre mensajes recibidos,
    reacciones a mensajes y confirmaciones de lectura.
  </li>
</ul>

## 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](https://app.ayrshare.com/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](https://app.ayrshare.com/manage-profiles) marcando la casilla "Messaging Active" para cada perfil, o utilizando el endpoint de creación o actualización [profiles](/apis/profiles/overview).

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.

<img src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/messaging/messaging-badge.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=cee009857e195b2835e913eb36c3b83f" width="60%" alt="Messaging badge" class="center" data-path="images/apis/messaging/messaging-badge.webp" />

### Habilitar la mensajería en la app de Instagram

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

<ul class="custom-bullets">
  <li>
    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**.
  </li>

  <li>Desplázate hasta la sección **How others can interact with you**.</li>
  <li>Toca **Messages and story replies**.</li>
  <li>Toca **Message requests**.</li>

  <li>
    En **Connected tool**, activa el interruptor **Allow access to messages**.
  </li>
</ul>

## Información importante sobre la mensajería

<Note>
  **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.
</Note>

<Note>
  **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.
</Note>

### 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

<ul class="custom-bullets">
  <li>
    Facebook e Instagram solo permiten recuperar los **últimos 20 mensajes** de las
    conversaciones existentes al vincular una cuenta por primera vez para mensajería.
  </li>

  <li>
    Si una conversación tiene más de 20 mensajes, solo los 20 más recientes serán
    accesibles inicialmente.
  </li>
</ul>

#### Después de la configuración inicial

<ul class="custom-bullets">
  <li>
    Una vez habilitada la mensajería, **todos los nuevos mensajes** enviados y recibidos
    serán totalmente accesibles.
  </li>

  <li>
    Ayrshare mantiene el historial completo de las conversaciones a partir de ese momento.
  </li>

  <li>
    Por ejemplo: si inicialmente recuperas 20 mensajes y luego se intercambian 100
    mensajes nuevos, podrás acceder a los 120 mensajes en total.
  </li>
</ul>

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

<ul class="custom-bullets">
  <li>
    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.
  </li>

  <li>
    **Plan Premium**: la mensajería es un complemento fijo de **\$49 al mes** por cuenta.
  </li>

  <li>
    **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.
  </li>

  <li>
    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.
  </li>

  <li>
    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.
  </li>

  <li>
    El número de mensajes, enviados o recibidos, en una conversación activa es
    ilimitado.
  </li>

  <li>
    Si necesitas aumentar el límite de conversaciones, ponte en contacto con tu
    representante de cuenta de Ayrshare.
  </li>
</ul>

Puedes ver el conteo actual de conversaciones con el [endpoint user](/apis/user/overview).

### 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](https://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](https://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:

<ul class="custom-bullets">
  <li>El control del hilo volverá automáticamente a Ayrshare.</li>
  <li>Deberías poder enviar mensajes con normalidad de nuevo.</li>
  <li>No se requiere ninguna otra acción por tu parte.</li>
</ul>

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

## Webhooks de mensajes

Consulta [Messages Webhooks](/apis/webhooks/actions#messages-action) para recibir automáticamente mensajes, confirmaciones de lectura o reacciones.