API de réseaux sociaux pour agences : gérez les comptes de vos clients depuis votre propre logiciel
Une API de réseaux sociaux pour agences permet au logiciel de l'agence de connecter, publier, répondre et produire des rapports sur les comptes de chaque client. Avec la Partner API d'easyCoexistence, le numéro WhatsApp d'un client ainsi que ses comptes Instagram, Facebook, TikTok, YouTube et LinkedIn rejoignent le compte de l'agence via des liens hébergés étiquetés avec l'id du client, et une seule clé API planifie, achemine et surveille l'ensemble.
La longueur maximale de external_ref acceptée par une session de connexion, l'id que l'agence attribue au client, conservé sur chaque connexion.
La durée de validité d'un lien de connexion hébergé pour le client qui l'ouvre.
Ce qu'il faut à une app Meta pour servir des comptes Instagram professionnels qu'elle ne possède ni ne gère, après App Review et la vérification de l'entreprise Meta.
Le rôle sur la Page LinkedIn dont un membre a besoin pour la permission rw_organization_admin, qui gère les Pages et lit leurs statistiques.
Le moment où la facturation s'arrête pour une connexion client que l'agence supprime via l'API.
Comment l'API organise-t-elle les clients d'une agence ?
Par votre id client. Envoyez-le en external_ref à chaque session de connexion : il reste sur chaque numéro et compte créé par la session et revient dans chaque événement de statut. GET /channels?external_ref=client_118 liste les comptes sociaux de ce client, avec &channel=instagram pour le restreindre à un seul réseau, et GET /connections?external_ref=client_118 liste ses numéros WhatsApp. Chaque client se trouve sur l'unique compte de l'agence, sous une seule clé ec_live_, ce qui place tout le décompte dans une seule tranche de prix.
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"Comment un client transmet-il son accès ?
Par un lien envoyé par l'agence. POST /connect-sessions avec le réseau comme channel, l'external_ref du client et le nom de l'agence comme partner_name renvoie une url. Le client l'ouvre, se connecte sur l'écran de consentement du réseau, ou passe par la fenêtre popup de Meta et scanne un QR code pour un numéro WhatsApp, puis revient sur le redirect_url de l'agence. Une connexion Facebook ou LinkedIn peut ramener plusieurs Pages d'un coup, chacune avec sa propre connexion : vérifiez la liste par rapport au brief du client.
Comment l'agence publie-t-elle pour ses clients ?
Depuis son propre circuit de validation. Le logiciel de l'agence garde les brouillons jusqu'à l'accord du client, puis envoie chaque publication validée à POST /channels/:id/posts avec son publish_at, jusqu'à 90 jours à l'avance. GET /channels/:id/posts donne le calendrier d'un compte, GET /posts avec un filtre status montre ce qui attend à travers les clients, et post.published et post.failed informent le chargé de compte de ce qui s'est passé. Les publications LinkedIn passent toujours par l'approbation d'une personne, ce que l'étape de validation de l'agence fournit déjà.
Comment l'agence répond-elle aux commentaires et messages privés de ses clients ?
Depuis une seule boîte de réception qui achemine par compte. PUT /channels/:id/webhook définit une destination pour chaque compte Instagram, chaque Page Facebook et chaque compte TikTok, et chaque commentaire, mention ou message privé transmis porte le account_id, qui correspond au client. Les messages d'un numéro WhatsApp partent de Meta vers le webhook_url qui lui est défini. Les réponses repartent par l'API de chaque réseau avec les identifiants renvoyés par GET /channels/:id?credentials=1, et l'équipe de l'agence peut aussi travailler sur plusieurs clients dans Claude ou ChatGPT grâce au connecteur MCP sur le même compte.
Comment l'agence produit-elle les rapports de ses clients ?
À partir des statistiques natives de chaque réseau, appelées avec les identifiants du compte client. Les statistiques Instagram et Facebook viennent de l'API Graph de Meta, celles de TikTok de son API for Business, celles de YouTube de YouTube Analytics, dont l'URL de base figure dans les identifiants, et celles de LinkedIn de ses endpoints de statistiques. La tâche de rapport de l'agence récupère des identifiants frais pour chaque compte au début de chaque exécution, extrait les chiffres de la période et les classe sous l'external_ref du client.
Comment l'agence sait-elle qu'un compte client a besoin d'attention ?
Grâce aux événements de statut signés. channel.disconnected et connection.disconnected portent l'external_ref du client, afin que le logiciel de l'agence puisse alerter le chargé de compte de ce client et lui envoyer un nouveau lien de connexion. Chaque connexion est surveillée 24 h/24 et 7 j/7, et le propriétaire de l'agence reçoit aussi un e-mail lorsqu'une connexion tombe. Un client qui retire son accès dans les paramètres du réseau apparaît de la même façon.
Que se passe-t-il dans l'API quand un client part ?
La tâche de départ de l'agence liste les connexions du client par external_ref et appelle DELETE /channels/:id et DELETE /connections/:id sur chacune. La facturation de ces connexions s'arrête à la fin du cycle, les publications programmées sur un canal supprimé sont annulées, et le token d'un compte social retiré est oublié. Un numéro WhatsApp reste sur la Cloud API tant que le client ne le déconnecte pas dans l'application WhatsApp Business.
Erreurs courantes
- Mettre en file des publications client avant l'accord du client. Une publication en file part à son heure sans nouvelle vérification, donc gardez les brouillons dans votre étape de validation et ne les envoyez qu'une fois approuvés.
- Placer la clé Partner API côté front d'un portail client. La clé donne accès aux identifiants de chaque client du compte, donc gardez-la sur le serveur de l'agence.
- Attendre des événements de commentaires depuis la chaîne YouTube ou la Page LinkedIn d'un client. easyCoexistence n'en reçoit d'aucune des deux, donc la tâche de rapport ou de boîte de réception les lit via l'API de chaque réseau.
easyCoexistence donne au logiciel de l'agence une seule API pour les numéros WhatsApp de ses clients et leurs comptes Instagram, Facebook, TikTok, YouTube et LinkedIn, ainsi que d'autres canaux à venir : liens de connexion hébergés étiquetés par client, file de publication, commentaires et messages privés transmis, identifiants frais pour les rapports et chaque connexion surveillée 24 h/24 et 7 j/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours gratuits.
Questions fréquemment posées
Les clients ont-ils besoin de leur propre compte easyCoexistence ?
Non. Le client ouvre le lien hébergé et se connecte, et la connexion rejoint le compte de l'agence, où elle est facturée et surveillée.
L'agence peut-elle garder ses clients sur des clés API séparées ?
Un compte ne détient qu'une clé. Des clés séparées impliquent des comptes easyCoexistence distincts, chacun facturé dès la première tranche, c'est pourquoi la plupart des agences séparent leurs clients par external_ref.
Le client voit-il le nom de l'agence lors de la connexion ?
Oui. La page hébergée affiche le nom envoyé en partner_name. L'écran de consentement du réseau désigne easyCoexistence comme l'application qui demande l'accès.
Combien coûte easyCoexistence pour une agence ?
De US$ 9 à US$ 0,75 par connexion client et par mois, dégressif à mesure que l'agence ajoute des clients, identique sur chaque réseau, avec les 3 premiers jours gratuits.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le