Aperçu
La fonctionnalité de jeton API multi-comptes permet aux organisations ayant plusieurs comptes Prokeep d’envoyer des messages en utilisant une seule intégration API.
Ceci est particulièrement utile pour les entreprises qui disposent d’un système ERP ou d’un système d’affaires centralisé — comme Epicor Eclipse ou Innovo — mais qui exploitent plusieurs comptes Prokeep à travers différentes succursales ou régions.
Au lieu de créer des intégrations distinctes pour chaque compte, vous pouvez envoyer des notifications de livraison de commandes ou d’autres messages via un seul point de terminaison, en utilisant un seul ensemble d’identifiants. Prokeep gère l’acheminement en fonction du numéro d’expéditeur (from number) inclus dans chaque requête.
À qui s’adresse cette fonctionnalité
Cette fonctionnalité est conçue pour les clients qui :
-
Exploitent plusieurs comptes Prokeep (par exemple par région, marque ou acquisition)
-
Possèdent un système ERP ou de messagerie centralisé
-
Veulent envoyer des messages (comme des notifications de commande) dans tous leurs emplacements sans fusionner les comptes
-
Ont besoin d’une intégration évolutive et nécessitant peu d’entretien
Fonctionnement
-
Prokeep fournit un nom d’utilisateur et mot de passe uniques (Basic Auth).
-
Utilisez l’endpoint standard POST /messages.
-
Prokeep détermine automatiquement le compte en fonction du numéro d’expéditeur (from) dans la requête.
-
Aucun besoin de gérer plusieurs jetons ou d’inclure des ID de compte dans les requêtes.
Exemple d’endpoint
Si votre URL de connexion est https://yourorg.prokeep.com, votre endpoint d’API de messagerie sera :https://yourorg.prokeep.com/rest/v1/messages
Cet endpoint unique fonctionne pour tous vos comptes Prokeep liés — par exemple :
-
northbranch.prokeep.com
-
southbranch.prokeep.com
-
hq.prokeep.com
Même si ces comptes ont des sous-domaines différents, vous utiliserez le même endpoint et les mêmes identifiants pour tous.
Tant que le numéro d’expéditeur (from) de la requête correspond à une ligne conversationnelle valide dans l’un de ces comptes, Prokeep redirigera automatiquement le message vers le bon compte.
👉 Pas besoin de changer de sous-domaine, de modifier des jetons ou d’ajouter des ID de compte.
Authentification
-
Utilise l’authentification de base (Basic Auth) avec nom d’utilisateur et mot de passe.
-
Les identifiants n’expirent pas sauf en cas de rotation manuelle.
-
Prokeep peut effectuer une rotation des identifiants sur demande.
Utilisation de l’API de messagerie
-
La structure de vos requêtes API reste la même que celle documentée dans l’API de messagerie Prokeep.
-
Le champ from doit être un numéro conversationnel valide lié à un groupe dans l’un des comptes connectés.
-
Prokeep gère le routage des messages — aucun ID de compte requis.
-
Seul l’endpoint POST /messages est pris en charge.
Pour voir la structure complète des requêtes et des exemples de réponses, consultez la documentation de l’API de messagerie Prokeep.
Exemple de requête
curl -u 'your_username:your_password' \
--request POST 'https://yourorg.prokeep.com/rest/v1/messages' \
--header 'Content-Type: application/json' \
--data-raw '{
"from": "+15556667777",
"to": "+15557776666",
"text": "Your order is out for delivery."
}'
Mise en route
Pour demander un jeton API multi-comptes :
-
Contactez votre gestionnaire de succès client (CSM).
-
La demande doit provenir d’un administrateur d’un des comptes.
-
Fournissez une liste des comptes à lier au jeton.
Votre CSM et votre gestionnaire de compte technique (TAM) vous fourniront :
-
Votre endpoint API (basé sur l’un de vos sous-domaines de compte)
-
Vos identifiants Basic Auth (nom d’utilisateur et mot de passe)
Notes importantes
-
Cette fonctionnalité prend actuellement en charge uniquement l’endpoint POST /messages.
-
Les journaux API dans l’application n’afficheront pas l’activité des jetons multi-comptes.
-
Les clients n’ont pas besoin de créer une clé API dans l’application Prokeep.