Webhooks

Events sind in Gruppen sortiert: Kontakte, Unterhaltungen, Nachrichten, Übergaben an dein Team, AI-Agent, Buchungen, Erinnerungen, Bestellungen, Produkte, Anrufe, Kampagnen, Formulare, Konto und Kanäle sowie Workspace-Einstellungen. Öffne eine Gruppe und wähle einzelne Events aus, oder drücke Alle auswählen, um die ganze Gruppe zu übernehmen. Nicht sicher, wo etwas liegt? Such einfach im Suchfeld, zum Beispiel nach „booking“ oder „tag“. Tippe auf ein Event, um ein Beispiel zu sehen, was Entagl genau senden wird. Bei manchen Events kannst du auch wählen, woher sie stammen, sodass du zum Beispiel nur die Buchungen bekommst, die deine AI erstellt hat, und die überspringst, die dein Team manuell in den Kalender eingetragen hat.

Eingehende Nachricht und Ausgehende Nachricht werden für jede einzelne Nachricht ausgelöst. Bei einem stark genutzten Konto können das Tausende pro Tag sein. Deshalb überspringt Alle auswählen sie: Du musst sie einzeln neben einer Warnung anhaken. Aktiviere sie nur, wenn das Tool auf der anderen Seite so viele verarbeiten kann. Wenn du nur wissen willst, wann ein Chat beginnt oder endet, sind Konversation geöffnet und Konversation geschlossen deutlich ruhiger.

Zwei Schalter bestimmen, wie viele Kundendaten Entagl verlassen. Message content einschließen ergänzt, was Kunden geschrieben haben: Nachrichten, Notizen und Anrufzusammenfassungen. Kontaktdaten einschließen ergänzt den Namen, die Telefonnummer und die E-Mail-Adresse des Kunden. Beide sind standardmäßig aus. Du erhältst trotzdem jedes Event auch ohne diese Daten, mit einer Kontakt-ID an der Stelle der Details. Nur der Workspace-Owner oder ein Admin kann sie aktivieren, und zwar nur, wenn das empfangende Tool Kundendaten speichern darf. In einem HIPAA-Workspace werden Kundendaten nie gesendet, egal was die Schalter sagen.

Tools und Entwickler können über die Entagl-API ihre eigenen Webhooks registrieren, und sie erscheinen von selbst unter Verbundene Apps. Für jede App siehst du, wie viele Events sie empfängt und wann zuletzt eines eingegangen ist. Du kannst Aktuelle Zustellungen öffnen, auf Pausieren oder Fortsetzen klicken oder auf Entfernen. Make-Szenarien haben eine eigene Seite: Kanäle → Make.

Drücke Letzte Zustellungen, um die letzten 50 Events zu sehen, die Entagl zu senden versucht hat, neueste zuerst. Bei jedem siehst du, ob es angekommen ist, welche Antwort dein Tool gegeben hat (zum Beispiel 200 oder 500), wie viele Versuche nötig waren und wann der nächste Versuch fällig ist. Wenn eine Zustellung endgültig fehlgeschlagen ist, behebe das Problem auf deiner Seite und drücke Erneut senden. Entagl sendet es dann innerhalb weniger Sekunden.

Wenn dein Tool nicht erreichbar ist oder einen Fehler zurückgibt, versucht Entagl es nach 30 Sekunden, 2 Minuten, 10 Minuten, 1 Stunde, 6 Stunden und 24 Stunden erneut. Das sind etwa 31 Stunden, bevor eine Zustellung als fehlgeschlagen markiert wird. Wenn eine verbundene App 3 Tage am Stück fehlschlägt, pausiert Entagl sie und sendet dem Workspace-Owner eine Benachrichtigung. Behebe das Tool und drücke dann Fortsetzen. Wenn Make meldet, dass ein webhook eines Szenarios nicht mehr existiert, hört Entagl sofort auf, dorthin zu senden.

Jede Anfrage enthält eine Signatur im Header X-Entagl-Signature, erstellt mit deinem Signing-Secret. Dein Entwickler nutzt sie, um nachzuweisen, dass die Anfrage von Entagl kommt und unterwegs nicht verändert wurde.

• Verbundene Apps und Webhooks, die über die API erstellt wurden, senden t=1767225600,v1=5257a869…. Der Teil t ist der Versandzeitpunkt in Sekunden. Jede v1 ist ein HMAC-SHA256 des Textes timestamp.body (dem t-Wert, einem Punkt und dann dem rohen Request-Body), erstellt mit deinem Secret. Lehne jede Anfrage ab, deren t älter als 5 Minuten ist, damit keine alte Anfrage erneut abgespielt werden kann. Direkt nach einer Secret-Änderung kannst du zwei v1-Werte sehen: Akzeptiere die Anfrage, wenn einer von beiden übereinstimmt.
• Der webhook, den du auf dieser Seite einrichtest, sendet sha256= gefolgt von einem HMAC-SHA256 des rohen Request-Bodys.