# 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'
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.msgerbot.de/entwicklung/events-and-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.