## Visión general

La **API REST** permite leer y escribir datos de la plataforma (contactos, conversaciones, mensajes y
más). La autenticación usa un **token de acceso**, y los **webhooks** entregan eventos a tu sistema en
tiempo real.

## Requisitos previos

- Un token de acceso válido.
- Un endpoint HTTPS para recibir webhooks.

## Paso a paso

1. Genera un token de acceso en la configuración.
2. Incluye el token en el encabezado de autenticación de tus llamadas a la API.
3. Realiza solicitudes a los recursos de la API (ej.: listar contactos, crear conversación).
4. Configura un webhook indicando la URL y los eventos deseados.
5. Valida la firma/secreto del webhook antes de procesar el payload.

## Configuración y opciones

- **Alcance del token**: limita el acceso a lo necesario.
- **Eventos del webhook**: suscríbete solo a los eventos que usas.
- **Reentrega**: maneja reintentos e idempotencia en tu endpoint.

## Casos de uso

- Replicar conversaciones en un data warehouse.
- Notificar a un sistema externo cuando una conversación se crea o se resuelve.

## Consejos, límites y buenas prácticas

- Verifica siempre la firma del webhook antes de actuar.
- Garantiza idempotencia (dedup por identificador del evento).
- Respeta los límites de tasa y usa backoff en errores 429/5xx.

## Solución de problemas

- **401/403**: token inválido o sin permiso.
- **Webhook duplicado**: implementa dedup por ID del evento.

## Ver también

- [Visión general de API y Desarrolladores](/hc/ajuda/articles/api-developers-overview-es)
- [Eventos por módulo](/hc/ajuda/articles/api-developers-eventos-por-modulo-es)