> 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/custom-channels/setup.md).

# Einrichtung

Schritt-für-Schritt-Anleitung zum Einrichten benutzerdefinierter Kanäle: erstellen, empfangen und Nachrichten senden.

{% stepper %}
{% step %}
**Erstellen Sie Ihren Kanal**

Gehen Sie zu **Einstellungen** > **Konten** > **Konto hinzufügen** > **Benutzerdefiniert** *(Selbst entwickeln)*. Wählen Sie aus, ob das Konto geteilt oder persönlich sein soll – dies kann später geändert werden. Wir empfehlen daher, mit einem persönlichen Konto zu beginnen und es zu teilen, wenn Sie bereit sind.

Sie sollten nun einen solchen Konfigurationsbildschirm sehen:

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-5f88410ca4b33dedb7a104da7be0d6af0591dae4%2Fsettings%202245cb29635c708dbf1ded02e23f187bafa96d5b331469e613cd86a483029d23.png?alt=media" alt="" width="563"></div>

Hier finden Sie Details zu jeder dieser Einstellungen:

**Kontoname**

Dieser Name wird in Ihrer **Konten** Einstellung verwendet, um den benutzerdefinierten Kanal zu identifizieren. Er kann später geändert werden.

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-61d9e28895eea25ba2be03708365209f340ba03e%2Faccount%20name%20c36ee0c9a4737f67729703f66236467f2da7c54dcf3189440b9ce97f5d138edb.png?alt=media" alt="" width="563"></div>

**Nachrichtentyp**

Benutzerdefinierte Kanäle unterstützen drei verschiedene Nachrichtentypen.

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-33b01343ee816ac4ff1dfa2a9afdc05ae8b81474%2Fmessage%20type%203eee6c5ae0fb3e1e0b05820e100d078a8d250570944d8113a32f088313762bc5.png?alt=media" alt="" width="563"></div>

Hier sind die wichtigsten Unterschiede zwischen den drei Typen:

| Funktionen                                                                                      | Text | HTML | E-Mail |
| ----------------------------------------------------------------------------------------------- | ---: | ---: | -----: |
| <p>Antworten erlauben (über den Webhook des benutzerdefinierten Kanals)<br>Felder: Von, An</p>  |    ✅ |    ✅ |        |
| <p>Antworten erlauben (über bestehende E-Mail-Konten)<br>Felder: Von, An, Cc, Bcc, Reply-To</p> |      |      |      ✅ |
| Rich Text (HTML)                                                                                |      |    ✅ |      ✅ |
| Einfacher Text + Emojis                                                                         |    ✅ |      |        |
| Blasenfarbe                                                                                     |    ✅ |      |        |
| Anhänge                                                                                         |    ✅ |    ✅ |      ✅ |

Sobald Ihr benutzerdefinierter Kanal erstellt wurde, können Sie **den Nachrichtentyp nicht ändern**.

**Ausgehende Nachrichten**

Die folgenden Einstellungen gelten nur für die **Text** oder **HTML** Nachrichtentypen.

Sie können festlegen, ob Missive Nutzern erlaubt, neue Nachrichten zu senden, auf bestehende Nachrichten zu antworten oder die Empfänger einer Antwort zu bearbeiten.

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-73512fbdff7a652c78e709ae9a01402751eb633f%2Foutgoing%20messages%20ef1fe45047daa0e72b4baa62b840940b7bfb0caf7910eb1c63389fa0b2dda2db.png?alt=media" alt="" width="563"></div>

**Aliasse**

Wenn Sie auf Nachrichten des benutzerdefinierten Kanals antworten oder neue Nachrichten erstellen, können Sie in Missive einen der vordefinierten Aliasse auswählen, die Sie in diesem Abschnitt festgelegt haben. Ein Alias kann aus drei Schlüsseln bestehen: `id`, `name` und `username`. Ihr Ausgehender Webhook kann diese beliebig verwenden. Sie sind alle optional, daher können Sie diejenigen deaktivieren, die Sie nicht verwenden werden:

* Festlegen der Empfänger-ID erlauben
* Festlegen des Empfängernamens erlauben
* Festlegen des Empfänger-Benutzernamens erlauben

Sie müssen außerdem die maximale Anzahl an Empfängern festlegen, die neue Nachrichten und Antworten haben können.

**Webhooks**

Weitere Informationen zu den webhook-Optionen finden Sie im Schritt „Nachrichten senden“.
{% endstep %}

{% step %}
**Nachrichten empfangen**

Um eingehende Nachrichten in Ihrem benutzerdefinierten Kanal zu erstellen, müssen Sie die Missive API verwenden. Erfahren Sie, wie Sie [beginnen](https://missiveapp.com/docs/developers/de/rest-api.md) und wie Sie [Nachrichten erstellen](https://missiveapp.com/docs/developers/de/rest-api/endpoints.md#create-message) in Ihrem Kanal mit dem `POST /messages` endpoint.

Beim Erstellen von Nachrichten müssen Sie Ihre Kanal-ID übergeben. Sie finden sie unter **Konto-ID** sobald Ihr Kanal erstellt wurde.

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-d543d22a3ff1cf364e05938bce6ff75602c78f48%2Faccount_id%20136a703768ff346070ca34ba3bd9700981adbd654688908f5b31babede85ed14.png?alt=media" alt="" width="563"></div>
{% endstep %}

{% step %}
**Nachrichten senden**

Um Nachrichten über den Benutzerdefinierten Kanal zu senden, müssen Sie einen Webhook-URL-Endpoint definieren. Jedes Mal, wenn Sie eine Nachricht aus Missive senden, wird die zugehörige Payload an diesen Endpoint gesendet.

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-b1936642a14ab967883ba63456445894e79ae177%2Fwebhook%20b38503f594024506efd3d804016f87271b55ad2268b5f06ead78530af41b88c5.png?alt=media" alt="" width="563"></div>

Die Anfrage-Payload sieht so aus:

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

```json
{
  "message": {
    "id": "a8ae9822-ec20-4cc7-989f-4ff4bc473cfe",
    "preview": "Hi, my name is Phil! How can I help you?",
    "type": "custom_text",
    "delivered_at": 1623269628,
    "updated_at": 1623269628,
    "created_at": 1623269608,
    "references": [],
    "body": "Hi, my name is Phil! How can I help you?",
    "from_field": {
      "id": null,
      "name": "My custom account",
      "username": "My custom account"
    },
    "to_fields": [
      {
        "id": "12345",
        "name": "Philippe Lehoux",
        "username": "@plehoux"
      }
    ],
    "external_id": null,
    "attachments": [],
    "author": {
      "id": "af577bfa-076f-4ff0-bcc0-9b2d578fc601",
      "email": "philippe@conferencebadge.com",
      "name": "Philippe Lehoux",
      "avatar_url": "https://missive.cdn.com/814942a3-ae65-4da5-b1ab-bd5266336ef4/philippe.png"
    }
  },
  "conversation": {
    "id": "15ff3085-4654-488d-a18f-aced2cc7dcc9",
    "subject": null,
    "latest_message_subject": "Message from Philippe Lehoux",
    "Organisation": null,
    "color": null,
    "assignees": [],
    "Nutzer": [
      {
        "id": "af577bfa-076f-4ff0-bcc0-9b2d578fc601",
        "name": "Philippe Lehoux",
        "email": "philippe@conferencebadge.com",
        "unassigned": false,
        "closed": false,
        "archived": false,
        "trashed": false,
        "junked": false,
        "assigned": false,
        "flagged": false,
        "snoozed": false
      }
    ],
    "attachments_count": 0,
    "messages_count": 2,
    "authors": [
      {
        "name": "My custom account",
        "address": null
      },
      {
        "name": "Philippe Lehoux",
        "address": null
      }
    ],
    "drafts_count": 0,
    "send_later_messages_count": 0,
    "tasks_count": 0,
    "completed_tasks_count": 0,
    "web_url": "https://mail.missiveapp.com/#inbox/conversations/15ff3085-4654-488d-a18f-aced2cc7dcc9",
    "app_url": "missive://mail.missiveapp.com/#inbox/conversations/15ff3085-4654-488d-a18f-aced2cc7dcc9",
    "assignee_names": "",
    "assignee_emails": "",
    "shared_label_names": "",
    "shared_labels": []
  }
}
```

{% endcode %}

Ihr Server ist dafür verantwortlich, dieses payload bei Bedarf zu verarbeiten, z. B. indem er über eine API eines Drittanbieters Ihrer Wahl eine Nachricht erstellt / sendet usw.

**Signatur-Secret (zum Validieren von Webhook-Anfragen)**

Wenn in Ihren Einstellungen für den Benutzerdefinierten Kanal ein Signature Secret definiert ist, enthalten alle Webhook-Anfragen ein `X-Hook-Signature` Hash-Signatur des payload. Mit dieser Signatur können Sie validieren, dass die Anfrage von Missive stammt. Um das zu erledigen, müssen Sie die Signatur selbst berechnen und mit der im request header angegebenen vergleichen.

Die Signatur beginnt mit `sha256=` gefolgt von einem HMAC-Hexdigest. Hier ist Beispielcode, der zeigt, wie Sie die Signatur in Ruby berechnen:

{% code title="Signatur berechnen (Ruby)" %}

```ruby
#
# `secret` ist das „Signaturgeheimnis“, das in den Einstellungen Ihres Benutzerdefinierter Kanal festgelegt ist.
# `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 Signatur im Header 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="Sicher vergleichen (Ruby)" %}

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

{% endcode %}
{% endstep %}
{% endstepper %}

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/custom-channels/setup.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.
