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

# Vue d'ensemble de l'API Messages

> Envoyez et recevez des messages directs sur Facebook, Instagram et 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} />

L'API de messagerie vous permet de gérer les messages directs (DM) envoyés aux correspondants qui contactent vos User Profiles.
Un correspondant est la personne avec laquelle votre utilisateur (User Profile) communique.
Une conversation est une série de messages entre votre utilisateur (User Profile) et son correspondant.

<ul class="custom-bullets">
  <li>
    L'API de messagerie est incluse dans tous les plans Ayrshare Business et sous forme
    de module complémentaire payant pour les plans Premium.
  </li>

  <li>
    Pour les plans Business comme Premium, vous devez activer la messagerie sur la
    page Account du tableau de bord Ayrshare.
  </li>

  <li>
    La messagerie est disponible pour Facebook Messenger, Instagram Direct Messenger
    et X Direct Messages.
  </li>
</ul>

<Card title="En savoir plus sur l'API de messagerie" icon="link" href="https://www.ayrshare.com/ayrshare-messaging-api-for-facebook-instagram-and-x-twitter/" horizontal />

## Principales fonctionnalités de messagerie

<ul class="custom-bullets">
  <li>Gérer les conversations de vos utilisateurs avec leurs correspondants.</li>

  <li>
    Envoyer des messages texte, image, vidéo et emoji au nom de vos utilisateurs.
  </li>

  <li>Récupérer l'historique complet des conversations.</li>
  <li>Configurer des réponses automatiques aux messages.</li>

  <li>
    Recevoir des mises à jour en temps réel via des webhooks pour les messages reçus, les
    réactions aux messages et les accusés de lecture.
  </li>
</ul>

## Activer la messagerie

### Activer votre compte Ayrshare et vos User Profiles

Vous devez d'abord activer la messagerie pour votre compte Ayrshare global afin de gérer les DM. Dans le tableau de bord Ayrshare, allez sur la [page Account](https://app.ayrshare.com/account), cliquez sur le bouton « Learn More » puis sur « Enable ». À ce stade, vous avez activé la messagerie pour votre compte global, *mais vous n'avez pas activé la messagerie pour les User Profiles individuels*.

Vous pouvez activer la messagerie pour des User Profiles individuels soit sur la [page User Profiles](https://app.ayrshare.com/manage-profiles) en cochant la case « Messaging Active » pour chaque profil, soit en utilisant le point de terminaison [create ou update profiles](/apis/profiles/overview).

Après avoir activé la messagerie pour un User Profile, vous devez re-lier le compte social (Facebook et Instagram) dans la page Social Accounts/Social Linking.
Une fois activé, vous verrez le badge « Messaging » sur le compte social lié.

<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" />

### Activer la messagerie dans l'application Instagram

Il se peut que vous deviez activer la messagerie pour votre compte Instagram :

<ul class="custom-bullets">
  <li>
    Rendez-vous sur votre profil dans l'application mobile Instagram et appuyez sur l'icône du menu ≡ dans
    le coin supérieur droit pour accéder à la page **Paramètres et activité**.
  </li>

  <li>Faites défiler jusqu'à la section **Comment les autres peuvent interagir avec vous**.</li>
  <li>Cliquez sur **Messages et réponses aux stories**.</li>
  <li>Appuyez sur **Demandes de message**.</li>

  <li>
    Sous **Outil connecté**, activez le commutateur **Autoriser l'accès aux messages**.
  </li>
</ul>

## Informations importantes sur la messagerie

<Note>
  **Une conversation doit être initiée par le correspondant.** Une fois une conversation
  établie, vous pouvez alors envoyer librement des messages, recevoir des messages, obtenir
  des réactions (par ex. des pouces levés) ou des accusés de lecture au nom de vos utilisateurs.
</Note>

<Note>
  **Votre utilisateur doit répondre à une conversation Instagram dans les 7 jours suivant le dernier
  message envoyé par le correspondant.** Si le correspondant n'a pas envoyé de message depuis
  7 jours, la conversation est considérée comme inactive et il n'est pas possible d'y répondre.
</Note>

### Récupération de l'historique des messages pour Facebook et Instagram

Lorsque vous activez pour la première fois la messagerie pour un user profile ayant un Facebook ou
un Instagram lié, il existe des limitations importantes concernant l'accès à l'historique des conversations :

#### Limitations de connexion initiale

<ul class="custom-bullets">
  <li>
    Facebook et Instagram n'autorisent la récupération que des **20 derniers messages** des
    conversations existantes lorsque vous liez pour la première fois un compte pour la messagerie
  </li>

  <li>
    Si une conversation comporte plus de 20 messages, seuls les 20 plus récents seront
    initialement accessibles
  </li>
</ul>

#### Après la configuration initiale

<ul class="custom-bullets">
  <li>
    Une fois la messagerie activée, **tous les nouveaux messages** envoyés et reçus seront
    entièrement accessibles
  </li>

  <li>
    Ayrshare maintient l'historique complet des conversations à partir de ce moment
  </li>

  <li>
    Par exemple : si vous récupérez initialement 20 messages, puis que 100 nouveaux messages
    sont échangés, vous pourrez accéder à un total de 120 messages
  </li>
</ul>

Cette limitation s'applique uniquement aux messages historiques qui existaient avant l'activation
de la messagerie - toute activité de conversation future pour Facebook et Instagram sera
entièrement préservée et accessible.

### Limite de conversations et tarification

<ul class="custom-bullets">
  <li>
    Chaque User Profile Ayrshare peut avoir jusqu'à **1 000 conversations actives par
    cycle de facturation**. Le nombre de conversations actives est la somme sur l'ensemble des réseaux
    sociaux.
  </li>

  <li>
    **Plan Premium** : la messagerie est un module complémentaire forfaitaire à **49 \$ par mois** par compte.
  </li>

  <li>
    **Plans Launch et Business** : la messagerie est facturée à **0,09 \$ par conversation
    active** via la facturation à l'usage Stripe. Des remises basées sur le volume sont
    disponibles ; contactez votre représentant de compte Ayrshare pour plus de détails.
  </li>

  <li>
    Une conversation est comptée comme active pour le cycle de facturation lorsque vous envoyez
    un message à un destinataire. Les messages entrants d'un destinataire ne suffisent pas, à eux
    seuls, à marquer une conversation comme active.
  </li>

  <li>
    Si la limite de 1 000 conversations est atteinte, vous pouvez toujours recevoir
    des messages, mais vous ne pourrez pas répondre avant le début du prochain
    cycle de facturation.
  </li>

  <li>
    Le nombre de messages, envoyés ou reçus, dans une conversation active est
    illimité.
  </li>

  <li>
    Si vous devez augmenter la limite de conversations, veuillez contacter votre
    représentant de compte Ayrshare.
  </li>
</ul>

Vous pouvez consulter le nombre de conversations en cours avec le [point de terminaison user](/apis/user/overview).

### Problèmes de contrôle de la messagerie sur Facebook et Instagram

Meta (Facebook et Instagram) utilise un système de « contrôle de thread » pour les conversations de messagerie. Cela signifie qu'une seule application peut envoyer des messages dans une conversation à la fois, tandis que les autres applications ne peuvent que recevoir des messages.

#### Qu'est-ce que cela signifie ?

Si vous voyez l'erreur **« Message failed to send because another app is controlling this thread now »**, cela signifie :

* Une autre application tierce contrôle actuellement cette conversation
* Ayrshare ne peut que recevoir des messages dans cette conversation
* Ayrshare ne peut pas envoyer de messages avant de reprendre le contrôle

#### Comment résoudre ce problème

Pour permettre à Ayrshare d'envoyer à nouveau des messages, vous devez supprimer l'application tierce qui contrôle la conversation.
Veuillez noter que Meta (Facebook et Instagram) peut mettre à jour le processus de suppression des applications tierces, utilisez donc les étapes suivantes comme directive générale.

**Pour les Pages Facebook :**

1. Allez sur [Facebook.com](https://facebook.com) et connectez-vous à votre compte
2. Cliquez sur le menu (☰) en haut à droite → **Paramètres et confidentialité** → **Paramètres**
3. Dans la barre latérale gauche, cliquez sur **Applications et sites Web**
4. Recherchez l'application tierce qui contrôle votre messagerie
5. Cliquez sur **Supprimer** à côté de cette application
6. Confirmez la suppression

**Pour les comptes Instagram Business :**

1. Ouvrez l'application Instagram sur votre téléphone
2. Allez sur votre **Profil** → appuyez sur le menu (☰) → **Paramètres et confidentialité**
3. Appuyez sur **Applications et sites Web**
4. Recherchez et supprimez l'application tierce

**Alternative pour Instagram :**

1. Allez sur [business.facebook.com](https://business.facebook.com)
2. Naviguez jusqu'à **Business Settings**
3. Sous **Accounts**, cliquez sur **Instagram Accounts**
4. Sélectionnez votre compte Instagram
5. Vérifiez les applications connectées et supprimez celle qui pose problème

#### Après la suppression

Une fois que vous avez supprimé l'application tierce :

<ul class="custom-bullets">
  <li>Le contrôle du thread reviendra automatiquement à Ayrshare</li>
  <li>Vous devriez pouvoir envoyer des messages normalement à nouveau</li>
  <li>Aucune action supplémentaire n'est requise de votre part</li>
</ul>

Si vous continuez à rencontrer des problèmes après avoir supprimé l'application, veuillez contacter notre équipe de support.

## Webhooks de messages

Consultez [Webhooks de messages](/apis/webhooks/actions#messages-action) pour recevoir automatiquement les messages, les accusés de lecture ou les réactions.