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

# Webhooks

Richten Sie Webhooks ein, um Benachrichtigungen über E-Mails, Labels und andere Missive-Ereignisse per HTTP POST zu empfangen.

{% hint style="info" %}
Missive bietet eine native [Zapier-Integration](https://missiveapp.com/integrations/zapier) mit der Sie Aktionen bei **neuen Kontakten**, **neuen Kommentaren**, **neuen Nachrichten (E-Mail, SMS)**, usw.
{% endhint %}

## Webhooks

Missive ermöglicht es Anwendungen, über bestimmte Aktionen (eingehende E-Mails, ausgehende E-Mails, Label-Änderungen usw.) in Form eines HTTP `POST` payload, das an eine URL gesendet wird.

Beispiel: Bei jedem eingehenden E-Mail-Eingang und unter bestimmten Bedingungen einen neuen Eintrag in einem CRM erstellen.

## Einrichtung

{% stepper %}
{% step %}

#### Eine webhook-Regel erstellen

Gehen Sie zu **Einstellungen** > **Regeln**, erstellen Sie eine neue Regel und wählen Sie **Webhook** als Aktion.

Beim Speichern der Regel sollte Ihr endpoint bereits so konfiguriert sein, dass er eine `POST` Anfrage erfolgreich empfangen kann. Es wird eine Validierungsanfrage gesendet, um sicherzustellen, dass Ihr endpoint funktioniert.
{% endstep %}

{% step %}

#### Stellen Sie sicher, dass Ihr endpoint Anfragen korrekt verarbeitet

* Der endpoint muss POST-Anfragen akzeptieren und innerhalb von 15 Sekunden antworten.
* Wenn Sie erwarten, Arbeiten auszuführen, die länger als 15 Sekunden dauern können, verwenden Sie eine Lösung für Hintergrundjobs (siehe zum Beispiel [diesen Artikel](https://devcenter.heroku.com/articles/background-jobs-queueing) über Hintergrundjobs und Queueing).
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
Hinweis: Sie müssen Administrator oder Inhaber einer Organisation sein, die den [Productive plan](https://missiveapp.com/pricing) oder [Business-Plan](https://missiveapp.com/pricing) abonniert hat, um Regeln zu erstellen.
{% endhint %}

## Anfrageformat

Jede webhook-Anfrage enthält ein JSON-Objekt. Das JSON-Objekt folgt dieser allgemeinen Struktur:

{% code title="webhook-payload.json" %}

```json
{
  "rule": {
    "id": "45408b30-aa3a-45n1-bh67-0a0cb8da9080",
    "description": "Notify elfs",
    "type": "label_change"
  },
  "conversation": {
    "id": "47a57b76-df42-4d8k-927x-80dbe5d87191",
    "subject": "Mordor GPS coordinates",
    "latest_message_subject": "Fwd: Mordor GPS coordinates",
    "Organisation": {
      "id": "93e5e5d5-11a2-4c9b-80b8-94f3c08068cf",
      "name": "Fellowship"
    },
    "team": {
      "id": "2f618f9e-d3d4-4a01-b7d5-57124ab366b8",
      "name": "Hobbits",
      "organization": "93e5e5d5-11a2-4c9b-80b8-94f3c08068cf"
    },
    "color": null,
    "assignees": [
      {
        "id": "6b52b6b9-9b51-46ad-a4e3-82ef3c45512c",
        "name": "Frodo Baggins",
        "email": "frodo@fellowship.org",
        "unassigned": false,
        "closed": false,
        "archived": false,
        "trashed": false,
        "junked": false,
        "assigned": true,
        "flagged": false,
        "snoozed": true
      }
    ],
    "assignee_names": "Frodo Baggins",
    "assignee_emails": "frodo@fellowship.org",
    "Nutzer": [
      {
        "id": "6b52b6b9-9b51-46ad-a4e3-82ef3c45512c",
        "name": "Frodo Baggins",
        "email": "frodo@fellowship.org",
        "unassigned": false,
        "closed": false,
        "archived": false,
        "trashed": false,
        "junked": false,
        "assigned": true,
        "flagged": false,
        "snoozed": true
      }
    ],
    "attachments_count": 0,
    "messages_count": 1,
    "authors": [
      {
        "name": "Samwise Gamgee",
        "address": "sam@fellowship.org"
      }
    ],
    "drafts_count": 0,
    "send_later_messages_count": 0,
    "tasks_count": 0,
    "completed_tasks_count": 0,
    "shared_labels": [
      {
        "id": "146ff5c4-d5la-3b63-b994-76711fn790lq",
        "name": "Elfs"
      }
    ],
    "shared_label_names": "Elfs",
    "app_url": "missive://mail.missiveapp.com/#inbox/conversations/47a57b76-df42-4d8k-927x-80dbe5d87191",
    "web_url": "https://mail.missiveapp.com/#inbox/conversations/47a57b76-df42-4d8k-927x-80dbe5d87191"
  },
  "latest_message": {
    "id": "86ef8bb8-269c-4959-a4f0-213db4e67844",
    "subject": "Fwd: Mordor GPS coordinates",
    "preview": "Hi Mr. Gamgee, I discovered something really disturbing about the Mordor coordinates we had.",
    "type": "email",
    "delivered_at": 1548415828,
    "updated_at": 1548434556,
    "created_at": 1548434555,
    "email_message_id": "<cMx4teIvYRDqVI9osfdRZKA@1.lotrmail.net>",
    "in_reply_to": [],
    "references": [],
    "from_field": {
      "name": "Samwise Gamgee",
      "address": "sam@fellowship.org"
    },
    "to_fields": [
      {
        "name": null,
        "address": "sam@fellowship.org"
      }
    ],
    "cc_fields": [],
    "bcc_fields": [],
    "reply_to_fields": []
  }
}
```

{% endcode %}

### Regelschritte

Wenn die webhook-Aktion in einem [Regelschritt](https://missiveapp.com/docs/advanced-features/rules/steps), angeben, `Regel` Objekt hat 3 weitere Schlüssel:

| Schlüssel              | Beschreibung                                                                                                               |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `parent_id`            | ID der Regel oder des Schritts über diesem Schritt                                                                         |
| `delay_seconds`        | Wie lange der Schritt wartet, nachdem die Regel oder der Schritt darüber ausgeführt wurde, in Sekunden                     |
| `delay_business_hours` | `null`, oder die Geschäftszeiten, in denen die Wartezeit zählt: `{ "organization_id": "..." }` oder `{ "team_id": "..." }` |

{% code title="webhook-payload.json" %}

```json
{
  "rule": {
    "id": "8c1e2f4a-3b5d-4e6f-9a7b-1c2d3e4f5a6b",
    "description": "An das Team eskalieren",
    "type": "incoming_email",
    "parent_id": "45408b30-aa3a-45n1-bh67-0a0cb8da9080",
    "delay_seconds": 10800,
    "delay_business_hours": {
      "organization_id": "93e5e5d5-11a2-4c9b-80b8-94f3c08068cf"
    }
  },
  ...
}
```

{% endcode %}

Die `type` Der Typ eines Schritts ist der Typ seiner Regel. Regeln, die keine Schritte sind, haben diese Schlüssel nicht.

{% hint style="warning" %}
**Breaking Change für WhatsApp**

Bei WhatsApp-Nachrichten ist das `id` in `from_field` und `to_fields` identifiziert Autoren und Empfänger anhand ihrer **Business-Scoped User ID (BSUID)**, die Kennung, die Meta verwendet, um einen WhatsApp-Nutzer innerhalb Ihres Unternehmens statt der Telefonnummer des Kontakts zu referenzieren. Zum Beispiel der `id` ändert sich von `whatsapp:+14155551234` zu `whatsapp:US.13491208655302741918`.

Wenn Ihre Integration auf diese angewiesen war `id` Werte, die eine Telefonnummer für WhatsApp sind, aktualisieren Sie sie so, dass sie die BSUID verwenden. Die `username` Feld enthält den WhatsApp-Benutzernamen des Kontakts, wenn er einen festgelegt hat, andernfalls fällt es auf seine Telefonnummer zurück.
{% endhint %}

## Fehlerbehandlung und erneuter Versuch

Wenn die Webhook-Anfrage einen Fehlerstatuscode zurückgibt oder innerhalb von 15 Sekunden keine Antwort zurückgibt, wird die Anfrage über einen Zeitraum von 8 Minuten bis zu 5 Mal erneut versucht. Wenn eine Webhook-Regel mehr als 50 Mal hintereinander fehlschlägt, wird die Regel automatisch deaktiviert. Sie können sie im Tab Regeln in den Einstellungen wieder aktivieren.

Verwenden Sie für Arbeit, die länger als 15 Sekunden dauern kann, eine Lösung für Hintergrundjobs. Siehe [diesen Artikel](https://devcenter.heroku.com/articles/background-jobs-queueing).

## Anfragevalidierung

Wenn für Ihre Regelaktion ein Validierungsgeheimnis definiert ist, enthalten alle Header der Webhook-Anfrage ein `X-Hook-Signature` Hash-Signatur des payload. Mit dieser Signatur können Sie prüfen, dass die Anfrage von Missive stammt. Berechnen Sie die Signatur dafür selbst und vergleichen Sie sie mit der im Anfrage-Header angegebenen.

Die Signatur beginnt mit `sha256=` gefolgt von einem HMAC-Hexdigest. Beispiel in Ruby:

{% code title="request-signature-example.rb" %}

```ruby
#
# `secret` ist das „Signature secret“, das Sie in Ihrer Missive-Regelaktion festgelegt haben
# `request_body` ist der vollständige HTTP-Request-Body
#
computed_signature = 'sha256=' + OpenSSL::HMAC.hexdigest(
  OpenSSL::Digest.new('sha256'), secret, request_body
)
```

{% endcode %}

Stellen Sie sicher, dass Sie die Gleichheit zwischen der Header-Signatur und der von Ihnen berechneten mit einer Methode prüfen, die Timing-Angriffe gegen normale Gleichheitsoperatoren verhindert. In Ruby können Sie secure\_compare verwenden:

{% code title="secure-compare-example.rb" %}

```ruby
valid = Rack::Utils.secure_compare(x_hook_signature, computed_signature)
```

{% endcode %}

## Webhook-FAQ

### Wie kann ich bestätigen, dass eine Regel tatsächlich ihren Webhook ausgelöst hat?

Aktivieren **Webhook-Ereignisse von Regeln anzeigen**. Gehen Sie zu **Einstellungen** > **Persönliche Einstellungen** > **Darstellung** und unter **Unterhaltungsansicht**, aktivieren Sie **Webhook-Ereignisse von Regeln anzeigen**. Tipp: Geben Sie `web` in die Suchleiste der Einstellungen ein, um direkt dorthin zu springen.

Sobald sie aktiviert ist, zeigt Missive jedes Mal, wenn eine Regel in einer Unterhaltung eine webhook-Aktion auslöst, direkt einen Eintrag in der Zeitachse der Unterhaltung an. Das ist eine Debugging-Hilfe: Wenn sich Ihr webhook nicht wie erwartet verhält, bestätigt der Eintrag, ob Missive den webhook ausgelöst hat, sodass Sie ein regelseitiges Problem von einem Problem auf Ihrem endpoint unterscheiden können.

Die Einstellung ist benutzerspezifisch und standardmäßig deaktiviert. Sie steuert nur die Sichtbarkeit, sodass das Ein- und Ausschalten vollständig abwärtskompatibel ist: Es erstellt oder löscht niemals etwas, und Sie können sie jederzeit umschalten.

### Mein Regel-webhook funktioniert nicht. Wurde die Regel nicht ausgelöst?

In der Regel nicht. Wenn eine webhook-Aktion nicht das erwartete Ergebnis liefert, wurde die Regel fast immer ausgelöst und Missive hat die `POST` Anfrage. Das Problem liegt typischerweise auf der Empfängerseite: ein falsch konfigurierter endpoint, ein Server, der nicht antwortet, oder eine Antwort, die ein Timeout hat. Missive klopft an die richtige Tür, aber niemand antwortet.

Aktivieren **Webhook-Ereignisse von Regeln anzeigen** (siehe oben), um zu bestätigen, dass der webhook auf Missive-Seite ausgelöst wurde, und prüfen Sie dann die Protokolle Ihres endpoints und das [Fehlerbehandlung und erneuter Versuch](#error-handling-and-retry) oben beschriebene Verhalten.

## Benötigen Sie genauere Antworten?

[Kontakt](https://missiveapp.com/docs/developers/de/contact.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://missiveapp.com/docs/developers/de/webhooks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
