API de WhatsApp para conectar leads, mensajes y eventos a tu sistema
Cuando el WhatsApp de la empresa ya es el SDRBOT.ai, tiene sentido que tu propio sistema también converse con él, sin depender de exportar hojas de cálculo ni copiar datos a mano. La API del SDRBOT.ai se autentica por una clave propia de la organización y permite enviar mensajes de WhatsApp, crear y consultar leads, y suscribirse a webhooks que avisan a tu sistema cuando pasa algo importante.
Crear mi SDR gratis →
Autenticación por clave, sin contraseña de usuario
Cada llamada se autentica con una clave de API propia de la organización, no con la contraseña de un usuario. La clave se genera en la pantalla de claves de API, disponible para quien tiene rol de propietario o administrador, y se manda en el encabezado de la petición. La clave completa se muestra una sola vez, en el momento de crearla; después de eso, ni la propia plataforma guarda el valor original, solo un hash.
Cada organización puede mantener hasta 10 claves activas al mismo tiempo — útil para darle una clave propia a cada sistema integrado, y revocar solo esa si alguno se descontinúa, sin afectar las demás integraciones. Toda llamada hecha con una clave queda registrada y alimenta un panel de uso de la API por clave.
Enviar mensaje y gestionar leads, todo con la misma clave
Con la clave de API puedes enviar un mensaje de WhatsApp — texto, plantilla aprobada, imagen, video, documento o audio — indicando el lead por su ID, por el teléfono o por el identificador de usuario de WhatsApp; si el contacto todavía no existe como lead, se crea al momento. Un lead que ya pidió no recibir más mensajes no recibe nada por esta vía, aunque la llamada se haga — la plataforma bloquea ese envío antes de que salga.
La misma clave da acceso al registro de leads — crear, consultar, actualizar y eliminar — y al envío de mensajes por RCS, cuando ese canal está activo en la organización. Para un mensaje fuera de la ventana de 24 horas de conversación libre de WhatsApp, la API exige una plantilla ya aprobada por Meta, con las variables correctas completadas — la misma regla que vale para cualquier envío manual desde la plataforma.
Los webhooks avisan a tu sistema, sin que tengas que preguntar
En lugar de consultar la API cada tanto, puedes registrar un webhook y elegir cuáles de los nueve eventos disponibles te interesan — lead creado, lead actualizado, lead calificado, mensaje recibido, mensaje enviado, derivación creada, derivación cerrada, negociación ganada o negociación perdida. En cuanto el evento ocurre de verdad en la plataforma, tu endpoint recibe la notificación, sin preguntar nada.
Cada envío de webhook va firmado con una clave propia de ese webhook, para que tu sistema confirme que la notificación vino realmente del SDRBOT.ai, y se reintenta automáticamente, con intervalo creciente, si tu endpoint no responde a la primera. Puedes consultar el historial de entregas de cada webhook y forzar un reintento a mano cuando tenga sentido, desde la propia API.
Documentación y pruebas, sin salir de la plataforma
La documentación de la API está publicada dentro de la propia plataforma, con los endpoints, parámetros y ejemplos de llamada organizados por área — leads, mensajes, RCS y webhooks —, siempre alineada con lo que está realmente disponible hoy. No hay que pedir acceso a un portal de desarrolladores aparte. También existe un endpoint que lista los eventos disponibles para suscribirse, útil para descubrir de forma programática qué webhooks configurar sin abrir la documentación en otra pestaña.
Cada webhook registrado tiene además un botón de prueba, que dispara una llamada de ejemplo a tu endpoint al momento, útil para confirmar que la integración está recibiendo los datos correctos antes de depender de ella en producción. El consumo de la API entra en la misma métrica de mensajes de tu plan, así que no es un límite aparte para vigilar.
Qué cambia para tu equipo
- Clave propiaAutenticación por clave de la organización, revocable en cualquier momento.
- Mensajes y leadsEnvía WhatsApp y RCS, y gestiona leads con la misma API.
- 9 eventos por webhookDe lead creado a negociación ganada, firmados y con reintento automático.
- Documentación vivaEndpoints, ejemplos y prueba de webhook dentro de la plataforma.
Preguntas frecuentes
¿Cómo funciona la autenticación de la API?
Por una clave propia de la organización, generada en la pantalla de claves de API por quien tiene rol de propietario o administrador, y enviada en el encabezado de la petición. La clave completa aparece una sola vez, al crearla; después de eso, ni la plataforma guarda el valor original, solo un hash.
¿Puedo enviar mensajes de WhatsApp directo por la API?
Sí. Se puede enviar texto, plantilla aprobada, imagen, video, documento o audio, indicando el lead por su ID, teléfono o identificador de WhatsApp — si el contacto todavía no existe como lead, se crea automáticamente. Los leads que pidieron no ser contactados quedan bloqueados en ese envío.
¿Cómo me entero de que algo pasó, sin estar consultando la API?
Registrando un webhook para los eventos que te interesan — lead creado, lead calificado, mensaje recibido, derivación cerrada, negociación ganada, entre otros. Cada notificación va firmada para que confirmes su origen, y la plataforma reintenta automáticamente si tu endpoint no responde a la primera.
¿Hay algún límite de uso de la API?
El consumo por mensaje enviado entra en la misma métrica de mensajes de tu plan, no es una cuota aparte para gestionar. También puedes mantener hasta 10 claves de API activas por organización, cada una con su propio historial de llamadas registrado para consultarlo.
Funciona junto con
Hecho para: Agencias y Consultoras Servicios Financieros SaaS y B2B