> 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/webhooks.md).

# Webhooks

Configure webhooks para recibir Notificaciones sobre correos, Etiquetas y otros eventos de Missive mediante HTTP POST.

{% hint style="info" %}
Missive ofrece una integración nativa [integración con Zapier](https://missiveapp.com/integrations/zapier) que le permite activar acciones sobre **nuevos contactos**, **nuevos comentarios**, **nuevos mensajes (correo electrónico, SMS)**, etc.
{% endhint %}

## Webhooks

Missive permite que las aplicaciones reciban notificaciones de ciertas acciones (correos entrantes, correos salientes, cambios de etiqueta, etc.) en forma de un HTTP `POST` payload enviado a una URL.

Ejemplo: crear una nueva entrada en un CRM cada vez que se recibe un correo y cumple ciertas condiciones.

## Cómo configurarlo

{% stepper %}
{% step %}

#### Crear una regla de webhook

Vaya a **Configuración** > **Reglas**, cree una nueva regla y seleccione **Webhook** como la acción.

Al guardar la regla, su endpoint ya debe estar configurado para recibir una `POST` solicitud correctamente. Se enviará una solicitud de validación para asegurarse de que su endpoint funciona.
{% endstep %}

{% step %}

#### Asegúrese de que su endpoint gestione las solicitudes correctamente

* El endpoint debe aceptar solicitudes POST y responder en 15 segundos.
* Si espera realizar trabajo que pueda tardar más de 15 segundos, use una solución de trabajos en segundo plano (por ejemplo, vea [este artículo](https://devcenter.heroku.com/articles/background-jobs-queueing) sobre trabajos en segundo plano y colas).
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
Nota: debe ser administrador o propietario de una organización suscrita al [plan Productive](https://missiveapp.com/pricing) o [plan Business](https://missiveapp.com/pricing) para poder crear reglas.
{% endhint %}

## Formato de la solicitud

Cada solicitud de webhook contiene un objeto JSON. El objeto JSON sigue esta estructura general:

{% 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",
    "organization": {
      "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",
    "usuarios": [
      {
        "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 %}

### Pasos de la regla

Cuando la acción de webhook se ejecuta en un [paso de la regla](https://missiveapp.com/docs/advanced-features/rules/steps), el `el objeto de la regla` tiene 3 claves más:

| Clave                  | Descripción                                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `parent_id`            | ID de la regla o del paso encima de este paso                                                                       |
| `delay_seconds`        | Cuánto tiempo espera el paso después de que se ejecutó la regla o el paso de arriba, en segundos                    |
| `delay_business_hours` | `null`, o el horario laboral en el que se cuenta la espera: `{ "organization_id": "..." }` o `{ "team_id": "..." }` |

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

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

{% endcode %}

El `type` El tipo de un paso es el tipo de su regla. Las reglas que no son pasos no tienen estas claves.

{% hint style="warning" %}
**Cambio incompatible para WhatsApp**

Para los mensajes de WhatsApp, el `id` in `from_field` y `to_fields` identifica a autores y destinatarios por su **ID de usuario con alcance empresarial (BSUID)**, el identificador que Meta usa para referenciar a un usuario de WhatsApp dentro de su empresa, en lugar del número de teléfono del contacto. Por ejemplo, el `id` cambia de `whatsapp:+14155551234` a `whatsapp:US.13491208655302741918`.

Si su integración dependía de estos `id` valores para ser un número de teléfono para WhatsApp, actualícela para usar el BSUID. La `username` campo almacena el nombre de usuario de WhatsApp del contacto cuando ha configurado uno; de lo contrario, usa su número de teléfono.
{% endhint %}

## Manejo de errores y reintentos

Si la solicitud de webhook devuelve un código de estado de error o no devuelve una respuesta en 15 segundos, la solicitud se reintentará hasta 5 veces durante un período de 8 minutos. Si una regla de webhook falla más de 50 veces seguidas, la regla se deshabilitará automáticamente. Puede volver a habilitarla desde la pestaña de configuración de Reglas.

Para realizar trabajo que pueda tardar más de 15 segundos, use una solución de trabajos en segundo plano. Vea [este artículo](https://devcenter.heroku.com/articles/background-jobs-queueing).

## Validación de la solicitud

Si se define un secreto de validación en la acción de su regla, todos los encabezados de la solicitud de webhook incluirán un `X-Hook-Signature` firma hash del payload. Con esta firma puede validar que la solicitud proviene de Missive. Para hacerlo, calcule la firma usted mismo y compárela con la proporcionada en el encabezado de la solicitud.

La firma comienza con `sha256=` seguido de un hexdigest de HMAC. Ejemplo en Ruby:

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

```ruby
#
# `secret` is the "Signature secret" you set in your Missive rule action
# `request_body` is the full HTTP request body
#
computed_signature = 'sha256=' + OpenSSL::HMAC.hexdigest(
  OpenSSL::Digest.new('sha256'), secret, request_body
)
```

{% endcode %}

Asegúrese de comparar la igualdad entre la firma del encabezado y la que ha calculado usando un método que impide ataques de temporización contra los operadores de igualdad normales. En Ruby, puede usar secure\_compare:

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

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

{% endcode %}

## Preguntas frecuentes sobre webhooks

### ¿Cómo puedo confirmar que una regla realmente activó su webhook?

Active **Mostrar los eventos de webhook de las reglas**. Vaya a **Configuración** > **Preferencias** > **Apariencia** y, en **Vista de conversación**, active **Mostrar los eventos de webhook de las reglas**. Sugerencia: escriba `web` en la barra de búsqueda de Configuración para ir directamente a ella.

Una vez activado, cada vez que una regla ejecute una acción de webhook en una conversación, Missive muestra una entrada directamente en la cronología de la conversación. Esto es una ayuda para depuración: si su webhook no se comporta como espera, la entrada confirma si Missive activó el webhook, para que pueda distinguir un problema del lado de la regla de un problema en su endpoint.

La opción es una preferencia por usuario, desactivada de forma predeterminada. Solo controla la visibilidad, así que activarla o desactivarla es totalmente retrocompatible: nunca crea ni elimina nada, y puede cambiarla en cualquier momento.

### Mi webhook de la regla no funciona. ¿La regla no se activó?

Normalmente no. Cuando una acción de webhook no produce el resultado esperado, casi siempre la regla sí se activó y Missive sí envió la `POST` solicitud. El problema suele estar en el lado receptor: un endpoint mal configurado, un servidor que no responde o una respuesta que agota el tiempo de espera. Missive toca la puerta correcta, pero nadie responde.

Active **Mostrar los eventos de webhook de las reglas** (vea arriba) para confirmar que el webhook se activó del lado de Missive, luego revise los registros de su endpoint y el [Manejo de errores y reintentos](#error-handling-and-retry) comportamiento anterior.

## ¿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/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.
