> 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/ui-iframe-integrations.md).

# UI-/iFrame-Integrationen

Erstellen Sie benutzerdefinierte UI-Integrationen mit iFrames, die über die JavaScript API mit Missive interagieren.

## iFrame-Integrationen

Sie können Ihre eigene Integration entwickeln, die mit einem iframe in Missive eingebunden wird und über eine JavaScript-Bibliothek mit unserer Anwendung interagieren kann.

### Bibliothek

Binden Sie dieses Skript in Ihre Integrationsseite ein. Sehen Sie sich die [JavaScript-API](https://missiveapp.com/docs/developers/de/ui-iframe-integrations/javascript-api.md).

```html
<script src="https://integrations.missiveapp.com/missive.js"></script>
```

### Stile

Zu Ihrer Bequemlichkeit stellen wir Ihnen außerdem ein Stylesheet zur Verfügung, das Sie einbinden können, wenn Ihre Integration unseren Stilen entsprechen soll. Es beschleunigt nicht nur die Entwicklung, sondern sorgt auch dafür, dass Ihre Integration standardmäßig alle unsere Themes unterstützt. Sehen Sie sich unser [CSS-Styleguide](https://integrations.missiveapp.com/styleguide/).

```html
<link href="https://integrations.missiveapp.com/missive.css" rel="stylesheet">
```

### Entwicklung

`https` ist erforderlich, wenn Sie eine benutzerdefinierte Integration zu Missive hinzufügen. Während der Entwicklung empfehlen wir die Verwendung eines Tools wie [Caddy](https://caddyserver.com/) oder [Ngrok](https://ngrok.com/) um einen sicheren Tunnel zu Ihrem lokalen Entwicklungsserver zu erstellen.

### iOS-Kompatibilität

iFrame-Integrationen werden auf iOS unterstützt. Missive unter iOS ist eine Web-App, die von `localhost`, was es bei iframe-Sicherheitsheadern strenger macht.

Wenn Ihre Integration im Web und auf dem Desktop geladen wird, aber auf iOS leer angezeigt wird, prüfen Sie Ihre `Content-Security-Policy` Header. Das Festlegen von `frame-ancestors: *` führt dazu, dass das iframe unter iOS nicht geladen wird. Entfernen Sie die `frame-ancestors` Direktive vollständig, um das Laden von `localhost`.

### Fehlersuche

Um Ihre Integration zu debuggen, benötigen Sie Zugriff auf die Browser-Konsole:

1. Öffnen Sie die Befehlsleiste mit <kbd>⌘/Ctrl</kbd> + <kbd>K</kbd>
2. Suchen nach `OPEN_DEV_TOOLS`
3. Wählen Sie den Befehl aus, um die Entwicklerwerkzeuge des Browsers zu öffnen

Dadurch erhalten Sie Zugriff auf die vollständige Browser-Konsole, in der Sie:

* die console.log-Ausgabe Ihrer Integration ansehen
* Fehler und Stack-Traces untersuchen
* JavaScript-Code debuggen
* Netzwerkanfragen prüfen
* Den DOM prüfen

## Sicherheit

Es gibt mehrere Möglichkeiten, wie Sie Ihr iFrame absichern können:

{% stepper %}
{% step %}

#### Authentifizierung direkt im iFrame implementieren (am sichersten)

Implementieren Sie die Authentifizierungslogik direkt in Ihrem iFrame, damit sich Ihre Nutzer vor dem Anzeigen des iFrame-Inhalts anmelden müssen.

Sie können Missives sicheren Speicher verwenden, um Authentifizierung dauerhaft zu speichern:

```javascript
// When user needs to authenticate
const token = await Missive.storeGet('auth_token')
if (!token) {
  // Anmeldeformular anzeigen
  // Nach erfolgreichem Login:
  await Missive.storeSet('auth_token', 'user_token_12345')
} else {
  // Token validieren und Inhalt anzeigen
}
```

* Werte werden pro Integration und pro Benutzer gespeichert
* Tokens bleiben beim Neuladen der Seite erhalten
* Der Speicher wird von Missive sicher verwaltet und beim Abmelden des Benutzers gelöscht
  {% endstep %}

{% step %}

#### Übergeben Sie ein Token in den URL-Parametern der Integration (am einfachsten)

Übergeben Sie ein Token in den URL-Parametern der Integration, die Ihr Server verwendet, um die Anfrage zu authentifizieren, bevor er den iFrame-Inhalt ausliefert.

Example URL entered in Missive: <https://acme.com/my-iframe?auth=12345abcde>
{% endstep %}

{% step %}

#### Delegieren Sie den OAuth-Flow mit initiateCallback an Missive (am besten für OAuth-Anbieter)

```javascript
async function authenticateWithOAuth() {
  try {
    // 1. Initiate OAuth flow
    const response = await Missive.initiateCallback('https://your-auth-endpoint')

    // 2. Response will contain query params from the OAuth redirect
    const { access_token } = response

    // 3. Store the token for future use
    await Missive.storeSet('oauth_token', access_token)
  } catch (error) {
    console.error('OAuth flow failed:', error)
  }
}
```

So funktioniert’s:

* Missive öffnet die Authentifizierungs-URL in einem neuen Browser-Tab
* Fügt einen `redirectTo` Parameter zu Ihrer URL hinzu
* Leiten Sie nach Abschluss von OAuth zu der bereitgestellten `redirectTo` URL mit Ihren Token/Daten als Abfrageparameter weiter
* Der Browser-Tab schließt sich automatisch
* Ihre Integration empfängt die Daten im `response` Objekt

Wichtige Hinweise:

* Umgeht die OAuth-Einschränkungen von iFrames
* Kompatibel mit iOS (verwendet localStorage statt Cookies)
* Die `redirectTo` URL ist pro Versuch eindeutig
* Speichern Sie die `redirectTo` URL während der OAuth-Weiterleitungen

Beachten Sie:

* Validieren Sie Tokens immer auf Ihrem Server
* Verwenden Sie HTTPS für die gesamte Kommunikation
  {% endstep %}
  {% endstepper %}

## Benötigen Sie Hilfe beim Erstellen Ihrer Integration?

Wenn Sie nicht über die technischen Kenntnisse verfügen, um eine benutzerdefinierte Integration zu erstellen, sehen Sie sich unsere [Partnerliste](https://missiveapp.com/partners) für Entwickler an, die Ihnen helfen können.

## 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/ui-iframe-integrations.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.
