Guía/SendApp Agent/Informes y API
Claves API y webhooks
Si quieres integrar SendApp Agent con tus sistemas (gestor, CRM, automatizaciones), la API es el camino. Aquí encuentras cómo autenticarte, qué puedes hacer y cómo recibir los eventos entrantes mediante webhook. Es una guía técnica, pero con los conceptos explicados paso a paso.
Actualizado el 16 de junio de 2026 · 6 min de lectura
Antes de empezar
- Una cuenta SendApp Agent con acceso API previsto por el plan
- Conocimientos básicos sobre peticiones HTTP
Obtener la clave API
- 1
Abre la sección «API»
Desde el menú abre API: aquí encuentras la clave de desarrollador (apikey) de tu cuenta.
- 2
Copia la clave
Úsala para autenticar tus peticiones. Trátala como una contraseña.
Cómo autenticarse
- URL base
- La API está en el dominio de tu cuenta, con prefijo /api (p. ej. https://tu-dominio/api). No uses «/v1» ni dominios distintos.
- Autenticación
- Pasa la clave en la cabecera HTTP «X-API-Key», o como parámetro «apikey» en la petición. No se usa el bearer token.
No compartas la clave API ni la insertes en código público (p. ej. JavaScript del lado del navegador): quien tenga la clave puede actuar en tu cuenta. Si queda expuesta, regenérala.
Qué puedes hacer vía API
- Enviar mensajes (p. ej. mediante el endpoint de envío de WhatsApp), dentro de los límites de las reglas del canal (en la API oficial de Meta, para escribir primero hace falta una plantilla aprobada).
- Gestionar los contactos de la agenda.
- Crear una nueva Cuenta (bot) de forma programática.
- Registrar la URL de tu webhook para recibir los eventos entrantes.
Los endpoints que aceptan la clave funcionan tanto con la cuenta titular como con un operador habilitado: asigna las claves con criterio según quién deba integrar.
Webhook: recibir los eventos
Con los webhooks recibes en tiempo real los eventos entrantes (p. ej. un nuevo mensaje de un canal). Registras la URL de tu endpoint mediante la API: a partir de ese momento SendApp envía los datos a tu sistema cuando se produce el evento. Es la forma de mantener alineado un CRM o un gestor externo.
Errores comunes
- 401 / no autorizado
- Clave ausente o incorrecta: comprueba la cabecera X-API-Key o el parámetro apikey.
- URL incorrecta
- Usa el dominio de tu cuenta con prefijo /api, sin «/v1».
- Demasiadas peticiones en un endpoint
- Algunos endpoints tienen un límite de frecuencia: distribuye las llamadas en lugar de concentrarlas.
¿Listo para ponerlo en práctica?
Abre SendApp y sigue los pasos de esta guía. ¿Necesitas ayuda? El soporte está a un mensaje de distancia.