Einführung

In diesem Blogbeitrag werden wir den Workflow für eine Bitrix24 Chatbot-Anwendung mit Webhook-Integration im Detail untersuchen. Dieser Workflow zeigt, wie Nachrichten verarbeitet, authentifiziert und entsprechend auf verschiedene Ereignisse in Bitrix24 reagiert werden kann.

1. Bitrix24 Handler (Webhook)

• Typ: Webhook
• Beschreibung: Dieser Node ist der Einstiegspunkt für den Workflow und empfängt POST-Anfragen von Bitrix24. Der Webhook wird auf dem Pfad bitrix24/handler.php konfiguriert.
• Einstellungen: Der HTTP-Method ist auf POST gesetzt, und die Antwort wird als responseNode gesendet.

2. Credentials (Set)

• Typ: Set
• Beschreibung: Hier werden die erforderlichen Authentifizierungsdaten für die Kommunikation mit Bitrix24 festgelegt, einschließlich CLIENT_ID, CLIENT_SECRET, und access_token.
• Einstellungen: Die Variablen werden aus den Webhook-Daten zugewiesen, um die Authentifizierung dynamisch zu handhaben.

3. Validate Token (If)

• Typ: If
• Beschreibung: Dieser Node prüft, ob der erhaltene application_token mit dem CLIENT_ID übereinstimmt, um sicherzustellen, dass die Anfrage authentifiziert ist.
• Einstellungen: Bedingungen sind so konfiguriert, dass sie entweder die Gleichheit zwischen CLIENT_ID und application_token überprüfen.

4. Route Event (Switch)

• Typ: Switch
• Beschreibung: Dieser Node leitet unterschiedliche Ereignisse, die von Bitrix24 empfangen werden, an verschiedene Verarbeitungseinheiten weiter. Mögliche Ereignisse sind ONIMBOTMESSAGEADD, ONIMBOTJOINCHAT, ONAPPINSTALL, und ONIMBOTDELETE.
• Einstellungen: Jedes Ereignis wird durch Bedingungen identifiziert, die den event Wert aus der JSON-Nachricht prüfen.

5. Process Message (Function)

• Typ: Function
• Beschreibung: Hier wird die eingehende Nachricht verarbeitet. Wenn der Benutzer „what’s hot“ eingibt, wird eine spezifische Antwort gegeben, andernfalls wird die Nachricht wiederholt.
• Einstellungen: Die Message und der dialogId werden für die Antwort vorbereitet. Der hochgeladene Token wird ebenfalls hinzugefügt.

6. Process Join (Function)

• Typ: Function
• Beschreibung: Dieser Node verarbeitet den Beitrittsnachricht des Benutzers zum Chat und sendet eine Willkommensnachricht zurück.
• Einstellungen: Der dialogId wird zum Senden der Antwort verwendet.

7. Process Install (Function)

• Typ: Function
• Beschreibung: Bei der Installation des Bots wird dieser Node aufgerufen, um den Bot bei Bitrix24 zu registrieren.
• Einstellungen: Der Handler-URL und Authentifizierungsdaten werden für die Registrierung festgelegt.

8. Register Bot (HTTP Request)

• Typ: HTTP Request
• Beschreibung: Dieser Node sendet eine Anfrage, um den Bot bei Bitrix24 zu registrieren.
• Einstellungen: Die URL und alle notwendigen Parameter werden für die Registrierung festgelegt.

9. Send Message (HTTP Request)

• Typ: HTTP Request
• Beschreibung: Dieser Node sendet eine Nachricht an den Benutzer im Chat.
• Einstellungen: Die URL wird so konfiguriert, dass sie die richtige Domain und AUTH-Token verwendet.

10. Send Join Message (HTTP Request)

• Typ: HTTP Request
• Beschreibung: Sendet eine Willkommensnachricht, wenn ein Benutzer dem Chat beitritt.
• Einstellungen: Wie beim vorherigen Node, aber spezialisiert auf den Beitrittskontext.

11. Process Delete (NoOp)

• Typ: NoOp
• Beschreibung: Dieser Node wird aufgerufen, wenn ein Bot gelöscht wird. Momentan tut er nichts, könnte aber zur Protokollierung genutzt werden.

12. Success Response (Respond to Webhook)

• Typ: Respond to Webhook
• Beschreibung: Sendet eine erfolgreiche Antwort zurück an Bitrix24, wenn ein Event erfolgreich verarbeitet wurde.
• Einstellungen: Die standardmäßige Antwort ist {