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

# Webhooks

> Conecta tu aplicación con eventos de Visito. Elige la configuración en el dashboard o la integración por API.

Los webhooks envían una notificación HTTPS a tu aplicación cuando ocurre un evento compatible en tu espacio de Visito: un mensaje nuevo, una actualización de entrega, una derivación o un cambio en una oportunidad de CRM.

## Elige por dónde empezar

<CardGroup cols={2}>
  <Card title="Configuración en el dashboard" icon="window-maximize" href="/es/product-guides/product/webhooks">
    Crea y administra endpoints con tu sesión de administrador, sin clave de API. Sigue la guía ilustrada para probar con ngrok, revisar entregas y resolver problemas de reintentos.
  </Card>

  <Card title="Referencia de API" icon="code" href="/es/api-docs/webhooks">
    Administra suscripciones mediante código. Consulta rutas, permisos, contenido de eventos, verificación de firmas y comportamiento de entrega.
  </Card>
</CardGroup>

## Cómo funciona la entrega

1. Crea una suscripción con un destino HTTPS público y los eventos que necesitas.
2. Guarda el secreto de firma del endpoint y verifica las solicitudes antes de procesarlas.
3. Acepta los eventos de forma persistente, deduplica por ID y monitorea los intentos de entrega.

Los eventos contienen metadatos e IDs de recursos. Consulta contenido adicional mediante la API con los permisos correspondientes. La entrega es al menos una vez y no garantiza orden; los fallos reciben hasta seis reintentos automáticos después del intento inicial.

## ¿Dashboard o API?

Ambas opciones usan los mismos eventos, firmas y sistema de entrega. La diferencia está en cómo administras la suscripción y autorizas las entregas.

| | Dashboard | Integración por API |
| - | - | - |
| Administrar suscripciones con | Sesión de administrador del espacio | Credencial de API con permisos |
| Las nuevas suscripciones pertenecen a | El espacio, administrado por sus administradores | La credencial que las autoriza |
| La entrega depende del vencimiento o revocación de la clave | No | Sí, salvo transferencia explícita al dashboard |
| Mejor punto de partida | Configuración guiada, pruebas e historial | Administración automatizada de suscripciones |

Los administradores pueden gestionar ambos tipos desde el dashboard. Una transferencia explícita conserva el endpoint y su historial, pero elimina la dependencia de la credencial. Las ediciones ordinarias no cambian silenciosamente el modo de autorización.

<Note>
  Estas guías cubren suscripciones de eventos M2M. Los webhooks de acciones **Capturar datos** se configuran por separado en Acciones.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.