Kurz gesagt
- Neun Ereignisse zur Auswahl.Unterhaltungen, Nachrichten, Übergaben, Status, Leads, Kontakte, Bewertungen, Buchungen und Nutzung.
- Signiert nach einem offenen Standard.Jede Zustellung folgt Standard Webhooks, sodass Ihr Server belegen kann, dass sie von OneType stammt.
- Wiederholungen über etwa drei Tage.Eine fehlgeschlagene Zustellung wird nach einem Zeitplan von 5 Sekunden bis zu 24 Stunden wiederholt.
- Ein Protokoll mit erneutem Senden.Sehen Sie 30 Tage lang jeden Versuch und senden Sie jedes Ereignis mit einem Klick erneut.
Ein Lead, der nur in einem Chat-Tool liegt, gerät in Vergessenheit. Ein Webhook ist eine Nachricht, die OneType an eine Adresse auf Ihrem Server schickt, sobald etwas passiert. Nutzen Sie ihn, um Leads in Ihr CRM zu übernehmen, Tickets zu eröffnen, Ihr Team zu benachrichtigen oder ein Dashboard zu aktualisieren, ohne dass jemand Daten von Hand kopiert.
Die Ereignisse
- conversation.created: Ein Besucher beginnt eine Unterhaltung.
- conversation.message.created: Eine Nachricht ist abgeschlossen, vom Besucher, vom Agenten oder von Ihrem Team.
- conversation.handoff.requested: Der Besucher oder der Agent verlangt einen Menschen.
- conversation.status.changed: open, escalated, resolved, unresolved oder failed.
- lead.captured und contact.identified: Ein Besucher hinterlässt Kontaktdaten oder wird als einer Ihrer angemeldeten Nutzer erkannt.
- usage.threshold.reached: Ihr Workspace erreicht 80 % oder 100 % seiner monatlichen Nutzung.
Jede Zustellung enthält dasselbe Objekt, das die REST-API für diese Ressource zurückgibt. Eine Nachricht enthält also auch die Angabe, ob sie von der KI geschrieben wurde. Sie können einen Endpunkt auf einzelne Ereignisse oder auf alle abonnieren.
Im Dashboard einrichten
Unter „Developer“, „Webhooks“ fügt ein Inhaber oder Administrator eine https-Adresse hinzu und wählt die Ereignisse aus. Das Signaturgeheimnis wird nur einmal angezeigt, speichern Sie es also sofort. Klicken Sie auf „Send test“, um einen signierten Ping zuzustellen und Antwortcode und Zeitverhalten zu sehen. Sie können das Geheimnis jederzeit rotieren: 24 Stunden lang signieren das alte und das neue Geheimnis jede Zustellung, sodass beim Wechsel nichts ausfällt.
Zustellungen, auf die Sie sich verlassen können
Antworten Sie innerhalb von 10 Sekunden mit einem beliebigen 2xx-Code, dann gilt die Zustellung als erfolgreich. Schlägt Ihr Server fehl oder ist er langsam, wiederholt OneType nach 5 Sekunden, 30 Sekunden, 2 Minuten, 10 Minuten, 30 Minuten, 1 Stunde, 3 Stunden, 6 Stunden, 12 Stunden und danach dreimal alle 24 Stunden. Die Zustellung erfolgt mindestens einmal. Speichern Sie daher den Header webhook-id, der bei jeder Wiederholung gleich bleibt, und ignorieren Sie Wiederholungen. Die Reihenfolge ist nicht garantiert.
Ein Endpunkt, der drei Tage lang nur fehlschlägt, wird abgeschaltet, und Inhaber sehen ein Banner mit „Turn back on“. Das Zustellprotokoll hält jeden Versuch 30 Tage lang fest, mit Status, Code, Zeitverhalten und einem Auszug der Antwort, und „Redeliver“ sendet ein Ereignis erneut.
Sicherheit
Jede Anfrage wird gemäß Standard Webhooks mit einem Zeitstempel signiert, sodass Sie alte oder wiederholt eingespielte Anfragen ablehnen können. OneType liefert nur an öffentliche https-Adressen, nie an private Netzwerke, und folgt keinen Weiterleitungen. Die Entwickler-Dokumentation enthält Code zur Prüfung für Node.js, Python und PHP.
Ideen für Ihren ersten Endpunkt
- Fügen Sie jeden Kontakt aus lead.captured Ihrem CRM oder Ihrer Mailingliste hinzu.
- Eröffnen Sie bei conversation.handoff.requested ein Ticket in Ihrem Helpdesk.
- Benachrichtigen Sie den Kanal Ihres Teams, wenn eine Unterhaltung eskaliert wird.
- Warnen Sie die Finanzabteilung, wenn usage.threshold.reached eintrifft.
Nur Inhaber und Administratoren können Endpunkte sehen und verwalten, und Geheimnisse werden nach dem ersten Mal nie wieder angezeigt. Andere Teammitglieder sehen Webhooks überhaupt nicht.