MCP-Server zur Verwaltung von WhatsApp Business Platform-Chats aus KI-Assistenten wie Meta Muse und Claude
Bleiben Sie in dem KI-Assistenten, den Sie bereits nutzen. Verbinden Sie ihn mit TimelinesAI, um Ihre WhatsApp Business Platform-Chats zu lesen, Kunden zu antworten, genehmigte Vorlagen zu senden und Chats für Ihr Team zuzuweisen und mit Labels zu versehen.
Der MCP-Server von TimelinesAI funktioniert mit jedem KI-Assistenten, der entfernte MCP-Server mit OAuth-Anmeldung unterstützt. Sie müssen keine Software installieren, keinen Server betreiben und kein Passwort weitergeben. Der Assistent kann nur das tun, was Ihre Rolle in TimelinesAI erlaubt.
Was der Connector kann
- Chats, Nachrichtenverlauf und Nachrichtenstatus über all Ihre WhatsApp Business Platform-Nummern lesen
- Mit freiem Text antworten, solange das 24-Stunden-Fenster des Kunden offen ist
- Von Meta genehmigte Vorlagen senden und neue Chats mit einer Vorlage starten
- Chats zuweisen und Zuweisungen aufheben, Chats öffnen und schließen sowie Labels hinzufügen oder entfernen
- Auf Nachrichten reagieren und Ihre Teammitglieder und Vorlagen sehen
Was Sie brauchen
- Ein TimelinesAI-Konto. Neue Konten starten mit einer 10-tägigen kostenlosen Testphase, ohne Kreditkarte.
- Mindestens eine WhatsApp Business Platform-Nummer (Cloud API), die mit Ihrem Workspace verbunden ist. Neu bei der WhatsApp Business Platform? Eine WhatsApp Business-Nummer im Meta Business Portfolio verbinden und aktivieren.
- Mindestens eine genehmigte Vorlage, wenn der Assistent neue Chats starten oder Kunden außerhalb des 24-Stunden-Fensters schreiben soll.
So richten Sie es ein
Schritt 1: Connector hinzufügen.
Fügen Sie in Ihrem KI-Assistenten einen neuen Connector (oder benutzerdefinierten MCP-Server) hinzu und fügen Sie
https://mcp.services.timelines.ai/mcp/wabaein.Schritt 2: Mit TimelinesAI anmelden.
Der Assistent öffnet die Anmeldeseite von TimelinesAI. Melden Sie sich an oder erstellen Sie ein Konto.
Schritt 3: Zugriff genehmigen.
Prüfen Sie die Berechtigungen auf der Seite „Authorize timelines-mcp?“ und klicken Sie auf Authorize.
Schritt 4: Stellen Sie Ihre erste Frage.
Versuchen Sie „Liste meine WhatsApp Business-Nummern auf“ oder „Zeige Chats, die auf eine Antwort warten“.
Verbindungsdetails
| Einstellung | Wert |
|---|---|
| MCP-Server-URL | https://mcp.services.timelines.ai/mcp/waba |
| Transport | Streamable HTTP |
| Anmeldung | OAuth 2.1 mit PKCE (S256) und dynamischer Client-Registrierung |
| Autorisierungsserver | https://mcp.services.timelines.ai |
| Scopes | openidchats:readchats:writemessages:readmessages:writelabels:readlabels:writeaccounts:readworkspace:readtemplates:read |
Tools (18)
Lese-Tools sehen sich nur Daten an. Schreib-Tools ändern einen Chat in TimelinesAI. Sensible Schreib-Tools senden etwas, das Ihr Kunde sieht, und Vorlagen werden von Meta berechnet.
| Tool | Was es tut | Zugriff |
|---|---|---|
waba_accounts | Listet die WhatsApp Business Platform-Nummern auf, von denen Sie senden können | Lesen |
waba_list_chats | Listet die Chats auf, die Sie sehen können, mit Filtern (zum Beispiel nach Telefonnummer) | Lesen |
waba_chat_details | Zeigt einen Chat: ob das 24-Stunden-Fenster offen ist, die zugewiesene Person, Labels und die sendende Nummer | Lesen |
waba_chat_history | Zeigt die Nachrichten eines Chats, die neuesten zuerst | Lesen |
waba_message_details | Zeigt eine Nachricht, einschließlich des Grundes, falls sie fehlgeschlagen ist | Lesen |
waba_templates | Listet die Nachrichtenvorlagen auf, die Sie verwenden können | Lesen |
waba_template_details | Zeigt eine Vorlage: Inhalt, Variablen, Status und die Nummern, von denen sie gesendet werden kann | Lesen |
workspace_team | Listet Teammitglieder auf, damit ein Chat einem von ihnen zugewiesen werden kann | Lesen |
waba_chat_open | Öffnet einen geschlossenen Chat wieder | Schreiben |
waba_chat_close | Schließt einen Chat | Schreiben |
waba_chat_assign | Weist einen Chat einem Teammitglied zu | Schreiben |
waba_chat_unassign | Entfernt die zugewiesene Person aus einem Chat | Schreiben |
waba_chat_set_label | Fügt einem Chat ein Label hinzu | Schreiben |
waba_chat_remove_label | Entfernt ein Label aus einem Chat | Schreiben |
waba_chat_send_message | Sendet eine Freitext-Antwort in einem bestehenden Chat, nur solange das 24-Stunden-Fenster offen ist | Sensibles Schreiben |
waba_chat_send_template | Sendet eine genehmigte Vorlage in einem bestehenden Chat | Sensibles SchreibenMeta berechnet Vorlagen |
waba_start_chat | Startet einen neuen Chat mit einer Telefonnummer über eine genehmigte Vorlage | Sensibles SchreibenMeta berechnet Vorlagen |
waba_message_react | Fügt einer Nachricht eine Emoji-Reaktion hinzu oder entfernt sie | Sensibles SchreibenDer Kunde sieht es |
Jedes Tool ist als schreibgeschützt oder als ändernd gekennzeichnet, damit KI-Assistenten Sie vor einem Schreibvorgang um Bestätigung bitten können.
Tool-Eingaben
Jedes Tool gibt die JSON-Antwort der TimelinesAI-API für diese Aktion zurück. Pflichtangaben sind fett. Der Assistent holt sich IDs zuerst über die Listen-Tools (zum Beispiel eine Chat-ID über waba_list_chats).
| Tool | Eingaben |
|---|---|
waba_accounts | Keine |
waba_list_chats | Alle optional: waba_account_id, responsible (E-Mail des Teammitglieds), closed (true oder false), whatsapp_phone, with_msg (letzte Nachricht einschließen), page (50 Chats pro Seite) |
waba_chat_details | chat_id |
waba_chat_history | chat_id. Optional: from_me, after und before (ISO-Datum oder Datum mit Uhrzeit), after_message und before_message (Nachrichten-ID), sorting_order (asc oder desc), page, size |
waba_message_details | message_uid |
waba_templates | Optional page |
waba_template_details | template_id |
workspace_team | Keine |
waba_chat_openwaba_chat_closewaba_chat_unassign | chat_id |
waba_chat_assign | chat_id, user_email (ein Teammitglied aus 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 und language einer genehmigten Vorlage. Optional variables: Listen header und body, in der Reihenfolge der Vorlage |
waba_start_chat | waba_account_id, phone (internationales Format mit führendem +), name und language einer genehmigten Vorlage. Optional variables, wie oben |
waba_message_react | message_uid, reaction (ein Emoji, oder ein leerer Wert zum Entfernen) |
Fehler und Limits
Wenn ein Aufruf fehlschlägt, gibt das Tool ein Fehlerergebnis mit dem HTTP-Status, der Meldung der TimelinesAI-API und, falls vorhanden, einem Fehlercode zurück. Der Assistent kann dann erklären, was passiert ist und was als Nächstes zu tun ist.
| Status | Bedeutung | Was tun |
|---|---|---|
| 400, 409, 422 | Die Anfrage wurde abgelehnt, zum Beispiel wegen einer fehlenden Eingabe oder einer Telefonnummer im falschen Format | Eingabe korrigieren und erneut versuchen |
| 401 | Die Anmeldung ist nicht mehr gültig | Connector neu verbinden und erneut bei TimelinesAI anmelden |
| 403 | Rolle oder Tarif des Benutzers erlauben diese Aktion nicht | Einen Inhaber oder Admin des Workspace fragen |
| 404 | Chat, Nachricht oder Vorlage wurde nicht gefunden | Die richtige ID über die Listen-Tools finden |
| 429 | Zu viele Anfragen | Kurz warten und erneut versuchen |
| 5xx oder keine Antwort innerhalb von 15 Sekunden | Vorübergehendes Problem bei TimelinesAI | Später erneut versuchen |
- 24-Stunden-Fenster: Ist das Fenster geschlossen, wird eine Freitext-Antwort abgelehnt. Senden Sie stattdessen eine genehmigte Vorlage.
waba_chat_detailsundwaba_list_chatszeigen, ob das Fenster offen ist. - Zustellung: Ein erfolgreicher Versand bedeutet, dass Meta die Nachricht angenommen hat. Schlägt die Zustellung später fehl, zeigt
waba_message_detailsden Grund. - Keine doppelten Sendungen: Sende-Tools werden nicht automatisch wiederholt. Wenn bei einem Versand eine Zeitüberschreitung auftritt, prüfen Sie
waba_chat_history, bevor Sie erneut senden, damit der Kunde die Nachricht nicht zweimal erhält. - Rate Limits: Der Connector setzt kein eigenes Limit. Die Messaging-Limits von Meta für Ihre WhatsApp Business Platform-Nummer gelten weiterhin für Vorlagennachrichten.
Was der Assistent sehen kann
Der Assistent handelt als der angemeldete TimelinesAI-Benutzer, mit dessen Berechtigungen. Er sieht nie mehr, als dieser Benutzer in TimelinesAI sehen kann.
- Inhaber und Admins sehen jede WhatsApp Business Platform-Nummer im Workspace und alle zugehörigen Chats.
- Teamleiter und Teammitglieder sehen die Nummern, deren Team ihr eigenes ist, und die Chats dieser Nummern.
- Agenten sehen die ihnen zugewiesenen Nummern und die Chats dieser Nummern.
- Mitwirkende sehen nur die ihnen zugewiesenen Chats. Sie können dort antworten, aber keine neuen Chats starten.
- Zugewiesene Chats: Wer einem einzelnen Chat zugewiesen ist, kann diesen Chat sehen und darin antworten. Der Rest dieser Nummer wird dadurch nicht freigegeben.
Regeln für Nachrichten
- Innerhalb des 24-Stunden-Fensters (der Kunde hat in den letzten 24 Stunden geschrieben) kann der Assistent Freitext-Antworten senden.
- Außerhalb des Fensters oder bei einem neuen Chat können nur von Meta genehmigte Vorlagen gesendet werden. Eine Vorlage öffnet das Fenster für Freitext nicht wieder.
- Vorlagen mit Medien-Header (Bild, Video oder Dokument) können noch nicht über den Connector gesendet werden. Verwenden Sie Vorlagen mit Textvariablen.
- Zustellung: Ein erfolgreicher Versand bedeutet, dass Meta die Nachricht angenommen hat. Die Zustellung kann später trotzdem fehlschlagen, und der Assistent kann den Grund prüfen.
Preise
Die Nutzung des Connectors ist in jedem TimelinesAI-Tarif ohne Aufpreis enthalten. Meta berechnet Vorlagennachrichten zu seinen Standardpreisen der WhatsApp Business Platform, und der Assistent sagt Ihnen Bescheid, bevor er eine sendet.
Datenschutz und Sicherheit
- Die Anmeldung erfolgt über OAuth, daher sieht Ihr KI-Assistent Ihr TimelinesAI-Passwort nie.
- Der Assistent kann nur die Daten nutzen, auf die der angemeldete Benutzer Zugriff hat, innerhalb der oben genannten Scopes.
- Um die Verbindung zu trennen, entfernen Sie den Connector in Ihrem KI-Assistenten.
- Siehe den Datenschutzhinweis für diesen Connector (auf Englisch) und die Nutzungsbedingungen. Hilfe: support@timelines.ai.
Häufige Fragen zum MCP-Server für die WhatsApp Business Platform
Zuletzt aktualisiert: