intoCHAT mit Zapier und Make verbinden

intoCHAT hat Apps für Zapier und Make. Sie starten einen Zap oder ein Szenario, sobald bei deinem Agenten etwas passiert, etwa ein neuer Lead, und sie lassen einen Zap oder ein Szenario eine Nachricht an deinen Agenten senden oder sein Wissen ergänzen. Sie bauen auf der REST-API und den Webhooks auf, arbeiten also mit denselben Daten und denselben Grenzen.

Welche Pläne die Apps enthalten

Die Apps nutzen die REST-API, die in Starter, Pro und Enterprise enthalten ist. Im Plan Free kannst du den API-Schlüssel, den sie brauchen, nicht erstellen. Wechselt dein Konto zurück zu Free, funktionieren die Apps nicht mehr, bis es wieder im Plan Starter oder höher ist. Siehe Welche Pläne die API enthalten.

Jede Antwort, die der Agent für Send a message to an agent schreibt, zählt als eine Nachricht deines Plans, wie im Chat-Widget. Trigger und die anderen Aktionen verbrauchen keine Nachrichten.

Was es gibt

Trigger

Die ersten sechs kommen sofort: intoCHAT sendet das Event innerhalb von Sekunden, genauso wie einen Webhook. New conversation hat keinen Webhook, deshalb sieht das Tool nach seinem eigenen Zeitplan nach neuen Gesprächen, in Zapier etwa alle paar Minuten, je nach deinem Zapier- oder Make-Tarif.

Jeder Trigger fragt nach dem Agent, den er beobachtet; die Liste zeigt jeden Agenten in deinem Konto. Die Ausgabe des Triggers sind die data des Events mit den Feldern, die unter Was gesendet wird beschrieben sind, bei einem neuen Lead zum Beispiel email, name und conversationId.

Aktionen

Neues Wissen zählt auf die Trainingszeichen des Agenten, und der Agent nutzt es, sobald das Training fertig ist. Siehe Text und Q&A.

Mit einem API-Schlüssel verbinden

1. Klicke in intoCHAT in der Seitenleiste unter Settings auf API keys.
2. Gib dem Schlüssel unter Create a key einen Name, an dem du ihn wiedererkennst, zum Beispiel Zapier.
3. Lass unter Access die Option Every scope, including ones added later gewählt. Willst du den Schlüssel stattdessen einschränken, wähle Only the scopes I choose und hake die Scopes aus der Tabelle unten an.
4. Klicke auf Create key, dann auf Copy.
5. Füge in Zapier oder Make einen intoCHAT-Schritt hinzu, wähle, dass du ein neues Konto verbinden willst, und füge den Schlüssel unter API key ein.

Nutze einen Schlüssel pro Tool, damit du einen widerrufen kannst, ohne das andere zu stoppen. Siehe API-Schlüssel erstellen.

Wie sofortige Trigger funktionieren

Schaltest du einen Zap ein oder fügst du in einem Make-Szenario einen sofortigen Trigger hinzu, bittet das Tool intoCHAT, dieses Event an eine eigene Adresse des Tools zu senden. intoCHAT speichert das als Webhook beim Agenten:

• Er erscheint im Tab Leads des Agenten unter Webhooks, gekennzeichnet mit via Zapier oder via Make. Siehe Von Integrationen erstellte Webhooks.
• Er wird zugestellt, wiederholt und protokolliert wie jeder Webhook, Recent deliveries zeigt also, was an das Tool gesendet wurde.
• Schaltest du den Zap aus oder löschst du den Trigger oder das Szenario in Make, entfernt das Tool den Webhook wieder.

Der Webhook jedes Events ist signiert, aber Zapier und Make können die Signatur nicht prüfen, deshalb nutzen die Apps das Signing Secret nicht. Die Adresse, die das Tool intoCHAT gibt, kennt nur dein Zap oder Szenario.

Beispieldaten

Testest du einen Trigger, lädt Zapier bis zu drei der letzten echten Events dieser Art des Agenten. Gibt es noch keine, etwa vor deiner ersten Buchung, zeigt es ein Beispiel mit denselben Feldern, damit du sie trotzdem zuordnen kannst. In Make kommt das Beispiel mit dem Modul; führe das Szenario einmal aus und löse ein echtes Event aus, um echte Daten zu sehen.

Schlüssel widerrufen

Widerrufst du unter Settings, API keys einen Schlüssel, funktionieren die Apps, die ihn nutzen, ab ihrer nächsten Anfrage nicht mehr, und die Webhooks, die dieser Schlüssel für Zapier oder Make erstellt hat, werden samt Zustellverlauf gelöscht. Die Zaps und Szenarien bleiben eingeschaltet, bekommen aber keine Events mehr. Um wieder zu verbinden, erstelle einen neuen Schlüssel, aktualisiere die Verbindung in Zapier oder Make und schalte den Zap aus und wieder ein (in Make erstellst du den Webhook des Triggers neu), damit ein neuer Webhook angelegt wird.

Grenzen

• Es gelten die Grenzen der REST-API: 60 Anfragen pro Minute und Schlüssel und die Nachrichten deines Plans für Send a message to an agent. Siehe Ratenlimits.
• Ein Agent kann bis zu 25 Webhooks von Integrationen haben, zusätzlich zu den 5, die du selbst hinzufügst. Schalte Zaps aus, die du nicht mehr nutzt, um Plätze frei zu machen.
• Die Trigger enthalten keine späteren Änderungen, etwa eine abgesagte Buchung oder eine erledigte Rücksendeanfrage.
• Beispieldaten für Hand-off requested, die aus früheren Übergaben neu aufgebaut werden, haben keine summary (sie wird nicht gespeichert); echte Events haben sie.

Fehlerbehebung

• Die Verbindung schlägt fehl. Prüfe, ob der Schlüssel mit ic_live_ beginnt, nicht widerrufen wurde und ob dein Konto im Plan Starter oder höher ist.
• Ein Trigger sagt, dem Schlüssel fehle ein Scope. Erstelle einen Schlüssel mit Every scope oder mit den oben genannten Scopes und verbinde neu.
• Ein Zap bekommt keine Events mehr. Prüfe den Tab Leads des Agenten: Fehlt sein Webhook via Zapier, wurde er in intoCHAT entfernt oder sein Schlüssel widerrufen. Schalte den Zap aus und wieder ein, um neu zu abonnieren. Ist der Webhook Paused, schalte ihn wieder ein.
• Zu viele Webhooks. Schalte Zaps aus oder lösche Make-Trigger, die du nicht mehr nutzt, oder entferne ihre Webhooks im Tab Leads.

Wie es weitergeht

• Was jedes Event enthält: Webhooks.
• Alle Endpunkte, die die Apps nutzen: REST-API.
• Dieselben Events ganz ohne Tool in einen Slack-Channel posten: Slack-Benachrichtigungen.