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

# Integraciones de IU/iFrame

Cree Integraciones de IU personalizadas con iFrames que interactúen con Missive usando la API de JavaScript.

## Integraciones de iFrame

Puede desarrollar su propia integración que se inyecta en Missive con un iframe que puede interactuar con nuestra aplicación mediante una biblioteca de JavaScript.

### Biblioteca

Incluya este script en su página de integración. Consulte la [API de JavaScript](https://missiveapp.com/docs/developers/es/ui-iframe-integrations/javascript-api.md).

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

### Estilos

Para su comodidad, también proporcionamos una hoja de estilos para que la incluya si quiere que su integración coincida con nuestros estilos. No solo acelera el desarrollo, también hará que su integración sea compatible con todos nuestros temas de forma predeterminada. Consulte nuestro [Guía de estilo CSS](https://integrations.missiveapp.com/styleguide/).

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

### Desarrollo

`https` es necesario al agregar una integración personalizada a Missive. Durante el desarrollo, sugerimos usar una herramienta como [Caddy](https://caddyserver.com/) o [Ngrok](https://ngrok.com/) para crear un túnel seguro a su servidor de desarrollo local.

### Compatibilidad con iOS

Las integraciones iFrame son compatibles en iOS. Missive en iOS es una aplicación web cargada desde `localhost`, lo que la hace más estricta con los encabezados de seguridad de iframe.

Si su integración se carga en la web y en el escritorio, pero aparece en blanco en iOS, revise sus `Content-Security-Policy` encabezados. Establecer `frame-ancestors: *` provocará que el iframe falle en iOS. Elimine la `frame-ancestors` directiva por completo para permitir la carga desde `localhost`.

### Depuración

Para depurar su integración, necesita acceso a la consola del navegador:

1. Abra la barra de comandos con <kbd>⌘/Ctrl</kbd> + <kbd>K</kbd>
2. Busque `OPEN_DEV_TOOLS`
3. Seleccione el comando para abrir las herramientas de desarrollo del navegador

Esto le da acceso a la consola completa del navegador, donde puede:

* Ver la salida de console.log de su integración
* Revisar errores y trazas de pila
* Depurar código JavaScript
* Revisar solicitudes de red
* Analizar el DOM

## Seguridad

Hay varias maneras de proteger su iFrame:

{% stepper %}
{% step %}

#### Implemente la autenticación dentro del iFrame (la opción más segura)

Implemente la lógica de autenticación en su propio iFrame para que sus usuarios tengan que iniciar sesión antes de ver el contenido del iFrame.

Puede usar el almacenamiento seguro de Missive para conservar la autenticación:

```javascript
// When user needs to authenticate
const token = await Missive.storeGet('auth_token')
if (!token) {
  // Mostrar formulario de inicio de sesión
  // Después de un inicio de sesión correcto:
  await Missive.storeSet('auth_token', 'user_token_12345')
} else {
  // Validar el token y mostrar el contenido
}
```

* Los valores se almacenan por integración y por usuario
* Los tokens persisten entre recargas de la página
* Missive gestiona el almacenamiento de forma segura y lo borra al cerrar sesión del usuario
  {% endstep %}

{% step %}

#### Pase un token en los parámetros de URL de la integración (la opción más sencilla)

Pase un token en los parámetros de URL de la integración que su servidor usará para autenticar la solicitud antes de servir el contenido del iFrame.

URL de ejemplo ingresada en Missive: <https://acme.com/my-iframe?auth=12345abcde>
{% endstep %}

{% step %}

#### Delegue el flujo OAuth a Missive con initiateCallback (mejor para proveedores OAuth)

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

    // 2. La respuesta contendrá los parámetros de consulta de la redirección de OAuth
    const { access_token } = response

    // 3. Guardar el token para uso futuro
    await Missive.storeSet('oauth_token', access_token)
  } catch (error) {
    console.error('Falló el flujo de OAuth:', error)
  }
}
```

Cómo funciona:

* Missive abre la URL de autenticación en una nueva pestaña del navegador
* Agrega un `redirectTo` parámetro a su URL
* Después de completar OAuth, redirija a la `redirectTo` URL con sus tokens/datos como parámetros de consulta
* La pestaña del navegador se cierra automáticamente
* Su integración recibe los datos en el `respuesta` objeto

Notas importantes:

* Resuelve las limitaciones de OAuth del iframe
* Compatible con iOS (usa localStorage en lugar de cookies)
* El método `redirectTo` URL es única para cada intento
* Guarde la `redirectTo` URL durante las redirecciones de OAuth

Recuerde:

* Valide siempre los tokens en su servidor
* Use HTTPS para todas las comunicaciones
  {% endstep %}
  {% endstepper %}

## ¿Necesita ayuda para crear su integración?

Si no cuenta con las habilidades técnicas para crear una integración personalizada, consulte nuestra [lista de partners](https://missiveapp.com/partners) de desarrolladores que pueden ayudarle.

## ¿Necesita respuestas más específicas?

[Contáctenos](https://missiveapp.com/docs/developers/es/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/es/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.
