Vue d'ensemble de l'API Messages

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.

• L’API de messagerie est incluse dans tous les plans Ayrshare Business et sous forme de module complémentaire payant pour les plans Premium.
• Pour les plans Business comme Premium, vous devez activer la messagerie sur la page Account du tableau de bord Ayrshare.
• La messagerie est disponible pour Facebook Messenger, Instagram Direct Messenger, X Direct Messages et WhatsApp (Private Beta).

​

Principales fonctionnalités de messagerie

• Gérer les conversations de vos utilisateurs avec leurs correspondants.
• Envoyer des messages texte, image, vidéo et emoji au nom de vos utilisateurs.
• Récupérer l’historique complet des conversations.
• Configurer des réponses automatiques aux messages.
• 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.

​

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, 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 en cochant la case « Messaging Active » pour chaque profil, soit en utilisant le point de terminaison create ou update profiles. 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é.

​

Activer la messagerie pour WhatsApp

Liez un compte WhatsApp Business via le flux embedded signup de Meta directement depuis le tableau de bord Ayrshare :

• Vous avez besoin d’un compte Meta Business Manager, d’un WhatsApp Business Account (WABA) et d’un numéro de téléphone éligible. Meta vérifie le compte et le numéro de téléphone pendant l’embedded signup.
• Sur la page Social Accounts, cliquez sur Link sur la tuile WhatsApp. Ayrshare lance la fenêtre pop-up embedded signup de Meta qui guide le client dans le choix ou la création de son Business Manager, WABA et numéro de téléphone, et dans l’acceptation des conditions de Meta.
• Une fois l’inscription terminée, Ayrshare vérifie la propriété du WABA et du numéro de téléphone sélectionnés, finalise l’enregistrement, et abonne le compte aux webhooks WhatsApp. Vous ne saisissez pas de PIN d’enregistrement distinct dans le tableau de bord Ayrshare.

​

Comportements spécifiques importants pour WhatsApp

• Les destinataires sont des numéros de téléphone, pas des ID. WhatsApp identifie les correspondants par un numéro de téléphone E.164 (chiffres uniquement, sans +). Les identifiants de conversation retournés par Ayrshare sont également le numéro de téléphone du correspondant — il n’y a pas d’identifiants de conversation opaques comme sur Facebook et Instagram.
• Fenêtre de service client de 24 heures. WhatsApp Business n’autorise l’envoi de messages sortants en format libre que dans les 24 heures suivant le dernier message du correspondant. En dehors de cette fenêtre, Meta rejette l’envoi. Les messages basés sur un modèle en dehors de la fenêtre de 24 heures ne sont pas actuellement pris en charge via Ayrshare.
• Adressez-vous directement à un destinataire avec l’API. Passez le numéro de téléphone du destinataire à Envoyer un message. Meta ne livre un message en format libre que lorsque ce destinataire est à l’intérieur de la fenêtre de service client de 24 heures. Des modèles approuvés sont requis pour la prospection à froid, et Ayrshare n’expose pas actuellement l’envoi via modèle.
• Le statut de livraison utilise un seul champ. Lorsqu’il est disponible sur un message sortant stocké, Obtenir les messages retourne status avec la valeur sent, delivered, read ou failed. Les mises à jour du statut de livraison et les réactions WhatsApp ne sont pas actuellement envoyées à votre URL de webhook enregistrée.
• Les types et tailles de médias suivent les limites de la WhatsApp Cloud API publiées par Meta — images jusqu’à 5 Mo, audio et vidéo jusqu’à 16 Mo, et documents jusqu’à 100 Mo au moment de la rédaction.

​

Médias WhatsApp pris en charge

• Image : .jpg, .jpeg, .png
• Vidéo : .mp4, .3gp
• Audio : .aac, .amr, .mp3, .m4a, .ogg
• Document : .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​

Activer la messagerie dans l’application Instagram

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

• 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é.
• Faites défiler jusqu’à la section Comment les autres peuvent interagir avec vous.
• Cliquez sur Messages et réponses aux stories.
• Appuyez sur Demandes de message.
• Sous Outil connecté, activez le commutateur Autoriser l’accès aux messages.

​

Informations importantes sur la messagerie

​

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

• 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
• Si une conversation comporte plus de 20 messages, seuls les 20 plus récents seront initialement accessibles

​

Après la configuration initiale

• Une fois la messagerie activée, tous les nouveaux messages envoyés et reçus seront entièrement accessibles
• Ayrshare maintient l’historique complet des conversations à partir de ce moment
• 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

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

• 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.
• Plan Premium : la messagerie est un module complémentaire forfaitaire à 49 $ par mois par compte.
• 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.
• 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.
• 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.
• Le nombre de messages, envoyés ou reçus, dans une conversation active est illimité.
• Si vous devez augmenter la limite de conversations, veuillez contacter votre représentant de compte Ayrshare.

Vous pouvez consulter le nombre de conversations en cours avec le point de terminaison user.

​

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

• Le contrôle du thread reviendra automatiquement à Ayrshare
• Vous devriez pouvoir envoyer des messages normalement à nouveau
• Aucune action supplémentaire n’est requise de votre part

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 pour recevoir automatiquement les messages, les accusés de lecture ou les réactions.