Events & Webhooks

Events

Events können Blöcke ausführen, sobald ein bestimmtes Ereignis ausgelöst wurde. Es gibt aktuell folgende Events, die von msgerbot unterstützt werden:

CHAT_START	Wird ausgelöst, wenn ein Chat gestartet wird.
WEB_CHAT_START	Wird ausgelöst, wenn ein Chat über die Website gestartet wird.
FACEBOOK_CHAT_START	Wird ausgelöst, wenn ein Chat über den Facebook Messenger gestartet wird.
TELEGRAM_CHAT_START	Wird ausgelöst, wenn ein Chat über Telegram gestartet wird.
FACEBOOK_LOCATION	Wird ausgelöst, wenn ein Nutzer die Abfrage des Standorts akzeptiert bzw. ablehnt.
TELEGRAM_HELP	Wird ausgelöst, wenn ein Nutzer während einer Unterhaltung mit dem Telegram-Bot /help eingibt.
TELEGRAM_SETTINGS	Wird ausgelöst, wenn ein Nutzer während einer Unterhaltung mit dem Telegram-Bot /settings eingibt.
CHAT_DATA_EXPORT	Wird ausgelöst, wenn ein Nutzer seine Daten von msgerbot exportiert.

Webhooks

Webhooks funktionieren auf die gleiche Weise wie Events. Sie unterscheiden sich nur im Auslöser. Denn ein Webhook kann bestimmte Blöcke ausführen, sobald die URL des Webhooks aufgerufen wird. Desweiteren können Daten an den Webhook übergeben werden, auf die dann in einem Block drauf zugegriffen werden kann.

Authentifizierung eines Webhook Aufrufs

Damit nicht jeder Ihre Webhooks aufrufen kann, ist es notwendig, dass Sie Ihre Zugriffe authentifizieren. Die Zugangsdaten für Ihren Chatbot finden Sie auf der Seite Einstellungen -> APIs & Dienste.

$ curl \
    -H 'Authorization: Bearer IHR_TOKEN' \
    'WEBHOOK_URL'