Ja, du kannst Dienstleistungen, Zeitfenster und Terminbuchungen über die API mit dem Terminmodul von Papo verwalten. Die REST-API ermöglicht es dir, Dienstleistungen, Mitarbeiter und Patienten aufzulisten, den Kalender abzufragen und neue Termine programmatisch zu erstellen, wodurch der gesamte Buchungsablauf in deine Website, App oder ein externes System integriert wird.
Das Terminmodul von Papo wurde als Steuerzentrale für deinen Kalender konzipiert. Es organisiert vier Säulen: die Dienstleistungen, die du anbietest (mit Name, Dauer und Preis), die Mitarbeiter, die sie ausführen, die Verfügbarkeit der Zeitfenster jedes Mitarbeiters und die gebuchten Termine. Mit der API kannst du diese Vorgänge automatisieren, ohne manuell auf das Dashboard zuzugreifen, und eine reibungslose Integration zwischen Papo und deinen anderen Tools aufrechterhalten.
Übersicht der Termin-Operationen über die API
| Vorgang | Was er macht | Wann verwenden |
|---|---|---|
| Dienstleistungen auflisten | Gibt die registrierten Termin-Dienstleistungen mit Dauer und Preis zurück. | Dienstleistungskatalog mit deiner Website oder App synchronisieren, damit der Kunde die Optionen in Echtzeit sieht. |
| Mitarbeiter auflisten | Gibt die Liste der Mitarbeiter oder Teammitglieder zurück, die die Dienstleistungen ausführen. | Verfügbare Mitarbeiter und ihre Spezialisierungen in einer externen Buchungsoberfläche anzeigen. |
| Patienten auflisten | Gibt die registrierten Patienten mit Name, Telefon und ID zurück. | Prüfen, ob ein Kunde bereits im CRM existiert, bevor ein neuer Termin erstellt oder mit einem vorhandenen Datensatz verknüpft wird. |
| Termine auflisten | Gibt die Termine mit Filter nach Status zurück (z. B. bestätigt, ausstehend). | Buchungen prüfen, in Berichtssysteme integrieren oder die Kalenderauslastung prüfen, bevor neue Zeitfenster angeboten werden. |
| Einen Termin buchen | Erstellt einen echten Termin im Kalender eines Mitarbeiters für eine bestimmte Dienstleistung und einen bestimmten Patienten. | Kunden direkt über deine Website oder App buchen lassen oder die Erstellung von Buchungen aus externen Systemen automatisieren. |
Wie die API-Authentifizierung funktioniert
Alle Schreibvorgänge in den Terminen erfordern den geheimen Schlüssel deines Papo-Kontos, der als Bearer-Token im Authorization-Header gesendet wird. Der öffentliche Schlüssel des Kontos ist optional, muss aber, wenn er gesendet wird, zum selben Konto wie der geheime Schlüssel gehören.
Die Basis-URL der API ist https://app.papo.global/api/v1. Die Schlüssel werden im Entwicklerbereich des Papo-Dashboards generiert. Der geheime Schlüssel wird bei der Erstellung nur einmal angezeigt; bewahre ihn an einem sicheren Ort auf und widerrufe ihn sofort, wenn ein Leck vermutet wird.
So verwendest du es in der Praxis
- Rufe den Entwickler-/API-Bereich im Papo-Dashboard auf und generiere einen geheimen Schlüssel. Kopiere auch den öffentlichen Schlüssel des Kontos.
- Authentifiziere dich bei jeder Anfrage mit dem geheimen Schlüssel als Bearer-Token. Wenn du die Validierung verstärken möchtest, sende den öffentlichen Schlüssel im in der Dokumentation angegebenen Header.
- Um die Buchungsoberfläche zu erstellen, liste zuerst die verfügbaren Dienstleistungen und Mitarbeiter auf. So kannst du die Optionen auf deiner Website oder App dynamisch mit den echten Daten deines Papo-Kontos befüllen.
- Um einen Termin zu erstellen, rufe den Endpunkt zur Terminerstellung auf und sende im JSON-Payload die Identifikatoren der Dienstleistung, des Mitarbeiters, des Patienten und das gewünschte Datum/die gewünschte Uhrzeit. Die API validiert die Verfügbarkeit im im Terminmodul konfigurierten Kalender und erstellt den Termin.
- Konsultiere die offizielle Dokumentation unter
https://papo.global/pt/docs, um die genauen Pfade, Pflichtparameter und Codebeispiele zu erhalten. Alle Antworten sind im JSON-Format.
Die API ermöglicht außerdem das Auflisten bestehender Termine mit Filter nach Status. Das ist nützlich, um Übersichts-Dashboards zu erstellen, automatische Erinnerungen zu versenden oder den Status der Buchungen mit anderen Systemen zu integrieren.
Für wen diese Integration geeignet ist
- Kliniken, Praxen und Schönheitssalons, die Online-Buchung auf der eigenen Website mit Echtzeit-Verfügbarkeit anbieten möchten.
- SaaS-Plattformen und Marktplätze, die den Kalender der Dienstleister mit einem externen Buchungssystem verbinden müssen.
- White-Label-Wiederverkäufer, die maßgeschneiderte Lösungen für Endkunden erstellen und das Terminmodul über die API bereitstellen möchten.
- Unternehmen mit automatisierten Abläufen, die die Erstellung von Terminen aus Ereignissen in CRMs, ERPs oder Automatisierungstools auslösen.
Häufig gestellte Fragen
Muss ich das Terminmodul konfiguriert haben, um die API zu verwenden?
Ja. Es ist erforderlich, dass Dienstleistungen, Mitarbeiter und deren Verfügbarkeiten bereits im Terminmodul von Papo angelegt sind, damit die API sie auflisten und Termine validieren kann.
Erlaubt die API das Erstellen einer neuen Dienstleistung oder eines neuen Mitarbeiters?
Die API-Ressourcen konzentrieren sich auf das Auflisten vorhandener Dienstleistungen und Mitarbeiter sowie auf die Buchung von Terminen. Um Dienstleistungen und Mitarbeiter zu erstellen oder zu bearbeiten, verwende das Papo-Dashboard.
Woher weiß die API, ob ein Zeitfenster frei ist?
Wenn du eine Anfrage zum Buchen eines Termins sendest, prüft die Papo-API die für den Mitarbeiter und die gewählte Dienstleistung an diesem Tag und zu dieser Uhrzeit konfigurierte Verfügbarkeit. Bei einem Konflikt wird der Termin nicht erstellt und die API gibt einen Fehler zurück.
Kann ich die API verwenden, um einen Termin im Namen eines Patienten zu buchen, der noch nicht im CRM ist?
Du kannst zuerst die Kontakte-API von Papo verwenden, um den Patienten zu erstellen (mit Name, E-Mail und/oder Telefon) und dann die zurückgegebene ID verwenden, um den Termin zu erstellen. Konsultiere die Dokumentation für den Endpunkt zur Kontakterstellung.
Kann die KI von Papo automatisch über die API buchen?
Die Künstliche Intelligenz von Papo, wie der Super Chat, bucht direkt über die WhatsApp-Konversation und prüft dabei den Kalender des Terminmoduls. Die API ist der Weg für externe programmatische Integrationen, wie ein Online-Buchungssystem.
Wo sehe ich das genaue Payload-Format für die Buchung?
In der offiziellen API-Dokumentation unter https://papo.global/pt/docs. Dort findest du Details zu Authentifizierung, Parametern, Antworten und Codebeispielen für die Termin-Ressourcen.
Lies auch
- So verwendest du die Papo-API zum Erstellen und Aktualisieren von Kontakten in Massen
- So verwendest du die Papo-API zum Erstellen und Verwalten von Etiketten (Tags)
Beginne, deinen Kalender über die API zu integrieren →
Registriere dich bei Papo und erhalte Zugriff auf die REST-API, um deine Terminbuchungen ab dem ersten Nutzer zu automatisieren.