API de réseaux sociaux multi-clients : une clé API pour les comptes de vos clients
L'API Partner d'easyCoexistence est multi-client par conception : une clé ec_live_ sur votre compte connecte et gère les numéros WhatsApp et les comptes sociaux de nombreux clients. Chaque connexion porte l'identifiant de votre client sous external_ref, détient le token propre à ce client, possède sa propre destination webhook et apparaît dans les événements de statut signés, de sorte que GET /channels?external_ref= liste les comptes d'un seul client.
Longueur maximale qu'une session de connexion accepte pour external_ref : votre identifiant du client, stocké sur la connexion créée.
Clés API qu'un compte easyCoexistence peut détenir simultanément ; des clés séparées signifient des comptes séparés, avec des factures séparées.
Sessions de connexion qu'un compte peut garder ouvertes en même temps, à côté d'une limite de 100 nouvelles sessions par heure.
Délai au-delà duquel l'horodatage d'un événement signé doit être rejeté, la comparaison du HMAC se faisant en temps constant.
Comment un seul compte sert-il de nombreux clients ?
Votre compte easyCoexistence représente votre produit, et chaque client est une étiquette sur les connexions qu'il apporte. Les clients ne créent aucun compte propre, ne voient jamais votre clé et sont facturés par vous, et non par easyCoexistence :
Comment étiqueter chaque connexion avec votre client ?
Envoyez external_ref dans la session de connexion. La valeur est stockée sur le numéro ou le canal créé par la session, ajoutée à la redirection et incluse dans ses événements de statut. Une connexion Facebook ou LinkedIn qui apporte plusieurs Pages étiquette chacune d'elles. Pour voir les comptes d'un client, filtrez l'une ou l'autre liste :
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"Comment les tokens des clients restent-ils séparés ?
Chaque connexion détient le token de son propre client. Le token d'un numéro WhatsApp est le token business émis par Meta lors d'Embedded Signup, limité aux actifs de ce client, et le token d'un compte social est celui que son propriétaire a accordé. Les identifiants ne transitent que par votre clé, depuis votre backend, et un ID absent de votre compte répond 404 not_found. Recherchez la connexion du client auquel appartient une tâche avant de récupérer son token, afin que le travail d'un client ne s'exécute jamais sur le compte d'un autre.
Comment fonctionnent les webhooks par client ?
Une destination par compte, choisie par vous. Pointez les canaux vers une seule URL et routez selon account_id dans le corps de la requête, ou donnez à chaque client sa propre URL. Chaque canal signe avec son propre secret, défini via PUT /channels/{id}/webhook ; account_id vous indique donc quel secret utiliser pour la vérification. Les messages d'un numéro vont de Meta vers son webhook_url, défini sur le WhatsApp Business Account : routez-les donc selon phone_number_id.
Comment les événements de statut indiquent-ils le client concerné ?
Grâce à l'external_ref qu'ils transportent. Une URL d'événements par compte reçoit les événements connection.* et channel.*, chacun avec la vue de la connexion ou du canal, external_ref inclus, tandis que post.published et post.failed transportent la publication et son canal. Les événements sont signés avec le secret propre au compte, dans X-EC-Signature, et renvoyés lorsque votre endpoint échoue ; traitez donc chaque identifiant de livraison une seule fois.
Avec quelle rapidité intégrer de nombreux clients ?
Au maximum 50 sessions de connexion ouvertes et 100 nouvelles par heure, par compte. Meta compte chaque première intégration WhatsApp contre une limite à l'échelle de l'application, partagée par tous les comptes easyCoexistence ; ces plafonds empêchent l'import d'une plateforme d'épuiser cette limite. Créez chaque session au moment où son client s'apprête à se connecter : un plafond répond 429 cap_reached ou rate_limited.
Que se passe-t-il si le compte d'un client est déjà connecté ailleurs ?
La connexion est refusée. Un compte social se connecte via un seul compte easyCoexistence à la fois : si un autre service utilisant easyCoexistence le détient, le last_error de la session l'indique, et le client le retire là-bas ou se connecte avec un autre compte. Au sein de votre propre compte, un client peut connecter autant de comptes qu'il en a besoin, chacun étiqueté avec le même external_ref.
Comment retirer un client ?
Listez ses connexions et ses canaux par external_ref, puis supprimez chacun via DELETE. Retirer un numéro révoque l'accès d'easyCoexistence chez Meta et arrête la surveillance ; retirer un canal révoque l'accès auprès du réseau et annule ses publications encore en attente dans la file. La facturation de chacun s'arrête à la fin du cycle, et les autres connexions du client, comme celles des autres clients, ne sont pas touchées.
Erreurs courantes
- Utiliser un e-mail comme external_ref. Les e-mails changent, et la valeur est stockée sur chaque connexion : utilisez donc l'identifiant stable de votre propre base de données.
- Vérifier les événements transmis avec le secret d'un autre client. Recherchez le secret à partir de l'account_id du corps, puisque chaque canal signe avec le sien.
- Envoyer les liens de connexion à toute votre base de clients d'un coup. Seules 50 sessions peuvent être ouvertes par compte : invitez donc les clients par vagues.
- Supprimer un client uniquement dans votre base de données. Ses connexions restent sur votre compte et sur votre facture tant que chacune n'a pas été retirée via l'API.
easyCoexistence permet à une seule clé API de servir toute votre base de clients : leurs numéros WhatsApp et leurs comptes Instagram, Facebook, TikTok, YouTube et LinkedIn, ainsi que d'autres canaux, chacun étiqueté avec votre identifiant client, avec son propre token, son webhook et ses événements signés, et chaque connexion surveillée 24/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Ai-je besoin d'un compte easyCoexistence par client ?
Non. Un seul compte et sa clé peuvent détenir les connexions de nombreux clients, distingués par external_ref. Des comptes distincts ne sont nécessaires que si vous voulez des factures séparées.
Mes clients peuvent-ils voir les comptes des autres ?
Pas via easyCoexistence. Ils ne détiennent jamais votre clé et n'ouvrent que leurs propres liens de connexion. Ce que chaque client voit dans votre produit est décidé par votre code.
Puis-je donner à chaque client une URL de webhook différente ?
Oui. Chaque numéro et chaque canal accepte sa propre destination : une URL propre à un client fonctionne, tout comme une URL partagée routée selon account_id.
Comment un compte multi-client est-il facturé ?
Par connexion, pour l'ensemble de vos clients : de US$ 9 à US$ 0,75 par connexion et par mois, selon la tranche de votre nombre total, avec un essai gratuit de 3 jours.
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