> For the complete documentation index, see [llms.txt](https://docs.msgerbot.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.msgerbot.de/entwicklung/events-and-webhooks.md).

# 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.

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