API de Respond.io: qué permite y desde qué plan
La API de desarrolladores de Respond.io permite crear y actualizar contactos, enviar y leer mensajes, abrir y cerrar conversaciones y asignar agentes, con autenticación por token. Está disponible desde el plan Growth, y los webhooks desde Advanced. El límite es de 5 peticiones por segundo por método y ruta.
Por Dilmer Huaman Loayza. Actualizada el 8 de octubre de 2026.
Esta guía es para quien ya decidió usar Respond.io y necesita conectarlo con su sistema: un ERP, una tienda, un panel interno. Si lo que buscas es conectar herramientas conocidas sin programar, eso está en integraciones de Respond.io.
Qué puedes hacer con ella
La API es REST, va por api.respond.io/v2 y se autentica con un token que envías en la cabecera Authorization como bearer. Puedes generar hasta diez tokens por espacio de trabajo, desde Ajustes, en la sección de integración.
Los recursos principales:
| Recurso | Qué permite |
|---|---|
| Contactos | Crear, consultar, actualizar, eliminar, fusionar y listar; ver los canales de un contacto |
| Mensajes | Enviar un mensaje por un canal concreto y recuperar los enviados |
| Conversaciones | Abrir y cerrar, asignar y desasignar agentes |
| Espacio | Listar usuarios, campos personalizados, canales, plantillas y etiquetas |
Un detalle práctico al enviar: si no indicas el canal, usa el último por el que interactuó el contacto. Va bien para responder y mal para campañas, donde conviene ser explícito.
Los webhooks, que suelen ser lo que de verdad hace falta
En vez de preguntar cada minuto si pasó algo, la plataforma avisa a tu servidor cuando ocurre. Los eventos cubren lo esperable: contacto nuevo, contacto actualizado, mensaje entrante, mensaje saliente, conversación abierta, conversación cerrada, cambio de etiquetas, cambio de asignado y comentario nuevo.
Dos condiciones que hay que respetar o te desactivan el webhook:
- Responder 200 en menos de 5 segundos. Si tu endpoint tarda más, cuenta como error y la desactivación automática es real. Lo correcto es encolar y procesar después.
- Verificar la firma. Hay secretos de firma para comprobar que el aviso viene de la plataforma y no de cualquiera que descubrió tu URL.
Los límites, con números
Cinco peticiones por segundo, por método y por ruta única, contadas a nivel de organización. Las rutas con parámetros se cuentan por separado: /v2/contact/id:1 y /v2/contact/id:2 son rutas distintas.
Las respuestas traen X-RateLimit-Limit y X-RateLimit-Remaining para que sepas cuánto te queda, y al pasarte recibes un 429 con Retry-After. El SDK de TypeScript lo maneja solo leyendo esa cabecera.
Si necesitas más, los límites altos son parte de Enterprise. Y hay un caso aparte: los canales personalizados tienen su propio límite, de 20 peticiones por segundo, que no conviene confundir con el general.
Errores que vas a ver
- 401: el token no vale. Suele ser que lo regeneraste y quedó el viejo en una variable de entorno.
- 403: la petición fue bloqueada por seguridad.
- 404: con ese token, ese recurso no existe. Ojo: puede ser un problema de permisos, no de que falte el dato.
- 429: te pasaste del límite. Respeta el
Retry-Afteren lugar de reintentar en bucle.
Qué conectaría yo, y en qué orden
- Pedidos. Que el estado del pedido llegue al contacto sin que nadie copie y pegue. Es lo que más tiempo ahorra.
- Alta de contacto desde tu sistema, para que la ficha llegue completa a la bandeja.
- Eventos hacia tu panel, para medir atención con tus propios indicadores.
- Mensajes salientes automáticos desde tu sistema, con cuidado: cada uno lo cobra Meta aparte, según su tarifario.
Antes de escribir código
Mucho de lo que la gente resuelve con la API se resuelve sin ella. Los workflows ya hacen peticiones HTTP, escriben en Google Sheets y actualizan campos del contacto. Merece la pena mirar si el caso entra ahí antes de montar un servicio que después hay que mantener.
Y antes de elegir plan, recuerda lo que condiciona todo: API desde Growth, webhooks desde Advanced. Los precios están en cuánto cuesta Respond.io.
Si quieres que lo integremos con tu sistema, escríbeme y lo vemos sobre tu caso.
Endpoints, autenticación, eventos de webhook, requisitos de plan y límites de peticiones, según la documentación oficial para desarrolladores y la ayuda de Respond.io, consultadas el 8 de octubre de 2026. La plataforma cambia su API con frecuencia: confirma siempre contra su documentación antes de implementar.
Preguntas frecuentes
¿Necesito un programador para usarla?
Para la API de desarrolladores, sí: es un servicio REST con token. Si lo que quieres es conectar con herramientas comunes sin programar, la plataforma trae integraciones hechas y pasos de workflow para enviar peticiones HTTP, que cubren la mayoría de los casos.
¿Desde qué plan está disponible?
La API de desarrolladores desde Growth y los webhooks desde Advanced, según la documentación de Respond.io. Si tu integración depende de recibir eventos en tiempo real, cuenta con el plan Advanced desde el inicio.
¿Qué límites tiene?
Cinco peticiones por segundo, contadas por método HTTP y por ruta única, a nivel de organización. Al superarlo devuelve un error 429 con la cabecera Retry-After. El plan Enterprise tiene límites más altos.