> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opptima.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción a los Webhooks

> Recibe eventos de tus envíos (entrega, apertura, click, rebote y más) en tiempo real.

Los **webhooks** te permiten recibir notificaciones automáticas cuando ocurre algo con tus mensajes: una entrega, una apertura, un click, un rebote o una baja. En lugar de consultar la API, Opptima **envía un `POST`** a la URL que configures cada vez que sucede un evento.

<Note>
  Los webhooks son **independientes de la API de envío**. Aquí no envías mensajes: configuras a dónde quieres recibir los eventos que genera la plataforma.
</Note>

## Configurar tu URL de webhook

<Steps>
  <Step title="Abre la configuración">
    Entra a [app.opptima.com/settings](https://app.opptima.com/settings) en tu cuenta.
  </Step>

  <Step title="Define la URL de callback">
    Ingresa la URL pública de tu servidor donde quieres recibir los eventos. Debe aceptar peticiones `POST` con cuerpo JSON.
  </Step>

  <Step title="Responde con 200">
    Tu endpoint debe responder `200 OK` para confirmar la recepción. Si falla, el evento puede reintentarse.
  </Step>
</Steps>

## Tipos de eventos

Opptima genera dos familias de eventos según el origen del mensaje:

<CardGroup cols={2}>
  <Card title="Email Marketing" icon="bullhorn" href="/webhooks/email-marketing/sent">
    Eventos de campañas: entrega, rebote, apertura, click, baja y queja.
  </Card>

  <Card title="SMTP / API" icon="paper-plane" href="/webhooks/smtp/sent">
    Eventos de correos transaccionales, incluyendo entrega certificada.
  </Card>
</CardGroup>

<Tip>
  Cada evento incluye el detalle del mensaje afectado. Consulta cada tipo de evento para ver su estructura exacta (payload).
</Tip>