Serveur MCP pour gérer les conversations WhatsApp Business Platform depuis des assistants IA comme Meta Muse et Claude
Restez dans l’assistant IA que vous utilisez déjà. Connectez-le à TimelinesAI pour lire vos conversations WhatsApp Business Platform, répondre aux clients, envoyer des modèles approuvés, et attribuer et étiqueter les conversations pour votre équipe.
Le serveur MCP de TimelinesAI fonctionne avec tout assistant IA qui prend en charge les serveurs MCP distants avec connexion OAuth. Aucun logiciel à installer, aucun serveur à gérer, aucun mot de passe à partager. L’assistant ne peut faire que ce que votre rôle dans TimelinesAI autorise.
Ce que le connecteur peut faire
- Lire les conversations, l’historique et le statut des messages sur tous vos numéros WhatsApp Business Platform
- Répondre en texte libre tant que la fenêtre de 24 heures du client est ouverte
- Envoyer des modèles approuvés par Meta et démarrer de nouvelles conversations avec un modèle
- Attribuer et désattribuer, ouvrir et fermer des conversations, et ajouter ou retirer des étiquettes
- Réagir aux messages, et voir les membres de votre équipe et vos modèles
Ce qu’il vous faut
- Un compte TimelinesAI. Les nouveaux comptes commencent par un essai gratuit de 10 jours, sans carte bancaire.
- Au moins un numéro WhatsApp Business Platform (Cloud API) connecté à votre espace de travail. Nouveau sur WhatsApp Business Platform ? Connecter et activer un numéro WhatsApp Business dans Meta Business Portfolio.
- Au moins un modèle approuvé, si vous voulez que l’assistant démarre de nouvelles conversations ou écrive à des clients en dehors de la fenêtre de 24 heures.
Comment le configurer
Étape 1 : Ajoutez le connecteur.
Dans votre assistant IA, ajoutez un nouveau connecteur (ou un serveur MCP personnalisé) et collez
https://mcp.services.timelines.ai/mcp/waba.Étape 2 : Connectez-vous avec TimelinesAI.
L’assistant ouvre la page de connexion de TimelinesAI. Connectez-vous ou créez un compte.
Étape 3 : Approuvez l’accès.
Vérifiez les autorisations sur la page « Authorize timelines-mcp? » et cliquez sur Authorize.
Étape 4 : Posez votre première question.
Essayez « Liste mes numéros WhatsApp Business » ou « Affiche les conversations en attente de réponse ».
Détails de connexion
| Paramètre | Valeur |
|---|---|
| URL du serveur MCP | https://mcp.services.timelines.ai/mcp/waba |
| Transport | Streamable HTTP |
| Connexion | OAuth 2.1 avec PKCE (S256) et enregistrement dynamique des clients |
| Serveur d’autorisation | https://mcp.services.timelines.ai |
| Scopes | openidchats:readchats:writemessages:readmessages:writelabels:readlabels:writeaccounts:readworkspace:readtemplates:read |
Outils (18)
Les outils de lecture consultent seulement les données. Les outils d’écriture modifient une conversation dans TimelinesAI. Les outils d’écriture sensible envoient quelque chose que votre client voit, et Meta facture l’envoi de modèles.
| Outil | Ce qu’il fait | Accès |
|---|---|---|
waba_accounts | Liste les numéros WhatsApp Business Platform depuis lesquels vous pouvez envoyer | Lecture |
waba_list_chats | Liste les conversations que vous pouvez voir, avec des filtres (par exemple, par numéro de téléphone) | Lecture |
waba_chat_details | Affiche une conversation : si la fenêtre de 24 heures est ouverte, la personne attribuée, les étiquettes et le numéro d’envoi | Lecture |
waba_chat_history | Affiche les messages d’une conversation, du plus récent au plus ancien | Lecture |
waba_message_details | Affiche un message, y compris la raison s’il a échoué | Lecture |
waba_templates | Liste les modèles de message que vous pouvez utiliser | Lecture |
waba_template_details | Affiche un modèle : son contenu, ses variables, son statut et les numéros depuis lesquels il peut être envoyé | Lecture |
workspace_team | Liste les membres de l’équipe, pour pouvoir attribuer une conversation à l’un d’eux | Lecture |
waba_chat_open | Rouvre une conversation fermée | Écriture |
waba_chat_close | Ferme une conversation | Écriture |
waba_chat_assign | Attribue une conversation à un membre de l’équipe | Écriture |
waba_chat_unassign | Retire la personne attribuée d’une conversation | Écriture |
waba_chat_set_label | Ajoute une étiquette à une conversation | Écriture |
waba_chat_remove_label | Retire une étiquette d’une conversation | Écriture |
waba_chat_send_message | Envoie une réponse en texte libre dans une conversation existante, uniquement tant que la fenêtre de 24 heures est ouverte | Écriture sensible |
waba_chat_send_template | Envoie un modèle approuvé dans une conversation existante | Écriture sensibleMeta facture les modèles |
waba_start_chat | Démarre une nouvelle conversation avec un numéro de téléphone à l’aide d’un modèle approuvé | Écriture sensibleMeta facture les modèles |
waba_message_react | Ajoute ou retire une réaction emoji sur un message | Écriture sensibleLe client le voit |
Chaque outil est marqué comme en lecture seule ou comme effectuant des modifications, pour que les assistants IA puissent vous demander confirmation avant une écriture.
Paramètres des outils
Chaque outil renvoie la réponse JSON de l’API TimelinesAI pour cette action. Les paramètres obligatoires sont en gras. L’assistant obtient d’abord les identifiants avec les outils de liste (par exemple, l’id d’une conversation avec waba_list_chats).
| Outil | Paramètres |
|---|---|
waba_accounts | Aucun |
waba_list_chats | Tous facultatifs : waba_account_id, responsible (e-mail du membre d’équipe), closed (true ou false), whatsapp_phone, with_msg (inclut le dernier message), page (50 conversations par page) |
waba_chat_details | chat_id |
waba_chat_history | chat_id. Facultatifs : from_me, after et before (date ou date-heure ISO), after_message et before_message (id de message), sorting_order (asc ou desc), page, size |
waba_message_details | message_uid |
waba_templates | page facultatif |
waba_template_details | template_id |
workspace_team | Aucun |
waba_chat_openwaba_chat_closewaba_chat_unassign | chat_id |
waba_chat_assign | chat_id, user_email (un membre d’équipe de workspace_team) |
waba_chat_set_labelwaba_chat_remove_label | chat_id, label |
waba_chat_send_message | chat_id, text |
waba_chat_send_template | chat_id, name et language d’un modèle approuvé. variables facultatif : listes header et body, dans l’ordre du modèle |
waba_start_chat | waba_account_id, phone (format international avec un + au début), name et language d’un modèle approuvé. variables facultatif, comme ci-dessus |
waba_message_react | message_uid, reaction (un emoji, ou une valeur vide pour la retirer) |
Erreurs et limites
Quand un appel échoue, l’outil renvoie un résultat d’erreur avec le statut HTTP, le message de l’API TimelinesAI et, s’il y en a un, un code d’erreur. L’assistant peut alors expliquer ce qui s’est passé et quoi faire ensuite.
| Statut | Signification | Que faire |
|---|---|---|
| 400, 409, 422 | La requête a été refusée, par exemple à cause d’un paramètre manquant ou d’un numéro de téléphone au mauvais format | Corrigez le paramètre et réessayez |
| 401 | La connexion n’est plus valide | Reconnectez le connecteur et reconnectez-vous à TimelinesAI |
| 403 | Le rôle ou l’offre de l’utilisateur ne permet pas cette action | Demandez à un propriétaire ou administrateur de l’espace de travail |
| 404 | La conversation, le message ou le modèle est introuvable | Trouvez le bon id avec les outils de liste |
| 429 | Trop de requêtes | Patientez un instant et réessayez |
| 5xx, ou aucune réponse en 15 secondes | Problème temporaire côté TimelinesAI | Réessayez plus tard |
- Fenêtre de 24 heures : si la fenêtre est fermée, une réponse en texte libre est refusée. Envoyez plutôt un modèle approuvé.
waba_chat_detailsetwaba_list_chatsindiquent si la fenêtre est ouverte. - Remise : un envoi réussi signifie que Meta a accepté le message. Si la remise échoue ensuite,
waba_message_detailsen indique la raison. - Pas d’envois en double : les outils d’envoi ne sont pas relancés automatiquement. Si un envoi expire, vérifiez
waba_chat_historyavant de renvoyer, pour que le client ne reçoive pas le message deux fois. - Limites de débit : le connecteur n’ajoute aucune limite propre. Les limites d’envoi de Meta pour votre numéro WhatsApp Business Platform s’appliquent toujours aux messages modèles.
Ce que l’assistant peut voir
L’assistant agit en tant qu’utilisateur TimelinesAI connecté, avec les autorisations de cet utilisateur. Il ne voit jamais plus que ce que cet utilisateur peut voir dans TimelinesAI.
- Propriétaires et administrateurs voient tous les numéros WhatsApp Business Platform de l’espace de travail et toutes leurs conversations.
- Superviseurs d’équipe et membres d’équipe voient les numéros rattachés à leur équipe, et les conversations de ces numéros.
- Agents voient les numéros qui leur sont attribués, et les conversations de ces numéros.
- Collaborateurs voient uniquement les conversations qui leur sont attribuées. Ils peuvent y répondre, mais pas démarrer de nouvelles conversations.
- Conversations attribuées : toute personne attribuée à une seule conversation peut la voir et y répondre. Cela ne donne pas accès au reste de ce numéro.
Règles d’envoi
- Dans la fenêtre de 24 heures (le client a écrit au cours des dernières 24 heures), l’assistant peut envoyer des réponses en texte libre.
- En dehors de la fenêtre, ou pour une nouvelle conversation, seuls les modèles approuvés par Meta peuvent être envoyés. Un modèle ne rouvre pas la fenêtre pour le texte libre.
- Les modèles avec un en-tête média (image, vidéo ou document) ne peuvent pas encore être envoyés via le connecteur. Utilisez des modèles avec des variables texte.
- Remise : un envoi réussi signifie que Meta a accepté le message. La remise peut encore échouer ensuite, et l’assistant peut en vérifier la raison.
Tarifs
L’utilisation du connecteur est incluse dans toutes les offres TimelinesAI sans frais supplémentaires. Meta facture les messages de modèle à ses tarifs standard de WhatsApp Business Platform, et l’assistant vous prévient avant d’en envoyer un.
Confidentialité et sécurité
- La connexion utilise OAuth, donc votre assistant IA ne voit jamais votre mot de passe TimelinesAI.
- L’assistant ne peut utiliser que les données auxquelles l’utilisateur connecté a accès, dans les limites des scopes ci-dessus.
- Pour vous déconnecter, retirez le connecteur dans votre assistant IA.
- Consultez l’avis de confidentialité de ce connecteur (en anglais) et nos Conditions. Aide : support@timelines.ai.
Questions fréquentes sur le serveur MCP pour WhatsApp Business Platform
Dernière mise à jour :