# Waspy

> Documentación oficial de la API de Waspy.

## Docs

- [Account](https://docs.waspytech.com/api-reference/account.md): Obtener información de tu cuenta.
- [Channels](https://docs.waspytech.com/api-reference/channels.md): Listar números de WhatsApp conectados.
- [Contacts](https://docs.waspytech.com/api-reference/contacts.md): Crear, listar, consultar y actualizar contactos.
- [Conversations](https://docs.waspytech.com/api-reference/conversations.md): Listar, consultar y actualizar conversaciones.
- [API Reference](https://docs.waspytech.com/api-reference/introduction.md): Todos los endpoints de la API v2 de Waspy.
- [Media](https://docs.waspytech.com/api-reference/media.md): Resolver mensajes con media (audio, imagen, video, documento) a URLs descargables.
- [Messages](https://docs.waspytech.com/api-reference/messages.md): Enviar mensajes de WhatsApp y consultar su estado.
- [Templates](https://docs.waspytech.com/api-reference/templates.md): Listar y consultar plantillas aprobadas por Meta.
- [Webhooks](https://docs.waspytech.com/api-reference/webhooks.md): CRUD de suscripciones a webhooks salientes.
- [Autenticación](https://docs.waspytech.com/authentication.md): Cómo autenticarte con la API de Waspy usando API keys.
- [Handoff humano (origin)](https://docs.waspytech.com/concepts/handoff.md): Cómo distinguir mensajes de tu bot, del panel humano, de la AI nativa o de campañas — y pausar el bot cuando un agente toma la conversación.
- [Estados de mensajes](https://docs.waspytech.com/concepts/message-status.md): Ciclo de vida de un mensaje enviado por WhatsApp.
- [Meta vs Waspy](https://docs.waspytech.com/concepts/meta-vs-waspy.md): Qué cobra Waspy, qué cobra Meta, y cómo se relacionan.
- [Planes y límites](https://docs.waspytech.com/concepts/plans-limits.md): Qué límites tiene cada plan y qué pasa cuando los alcanzás.
- [Ventana de servicio](https://docs.waspytech.com/concepts/service-window.md): Qué es la ventana de 24 horas de WhatsApp y cómo afecta al envío de mensajes.
- [Errores](https://docs.waspytech.com/errors.md): Formato de errores, códigos comunes y cómo manejarlos.
- [Crear y gestionar API keys](https://docs.waspytech.com/guides/api-keys.md): Cómo crear, configurar y rotar API keys.
- [Gestionar contactos](https://docs.waspytech.com/guides/manage-contacts.md): Crear, buscar y actualizar contactos desde la API.
- [Enviar tu primer mensaje](https://docs.waspytech.com/guides/send-first-message.md): Paso a paso para enviar un mensaje de WhatsApp con la API.
- [Enviar un template](https://docs.waspytech.com/guides/send-template.md): Cómo enviar plantillas aprobadas con variables dinámicas.
- [Idempotencia](https://docs.waspytech.com/idempotency.md): Cómo evitar envíos duplicados usando Idempotency-Key.
- [Introducción a la API](https://docs.waspytech.com/introduction.md): Todo lo que necesitás saber antes de hacer tu primera request a la API de Waspy.
- [Limitaciones conocidas](https://docs.waspytech.com/limitations.md): Lo que la API v2 todavía NO soporta — para que puedas planear tu integración con datos reales.
- [Paginación](https://docs.waspytech.com/pagination.md): Cómo paginar resultados con page-based y cursor-based.
- [Quickstart](https://docs.waspytech.com/quickstart.md): Enviá tu primer mensaje por WhatsApp en 5 minutos.
- [Rate limits](https://docs.waspytech.com/rate-limits.md): Límites de requests, headers de respuesta y cómo manejar 429.
- [Scopes y permisos](https://docs.waspytech.com/scopes.md): Qué scopes existen, qué endpoints protegen y cómo configurarlos.
- [Catálogo de eventos](https://docs.waspytech.com/webhooks/events.md): Payloads exactos de cada evento que entrega Waspy.
- [Introducción a Webhooks](https://docs.waspytech.com/webhooks/introduction.md): Recibí eventos en tiempo real cuando llegan mensajes, cambian estados o se crean contactos/conversaciones.
- [Verificación de firma](https://docs.waspytech.com/webhooks/security.md): Cómo validar que un webhook viene realmente de Waspy.

## Optional

- [Estado del servicio](https://waspytech.com)