Skip to main content
La API pública de Dialtu permite que tus propios sistemas — un CRM, un formulario web, un flujo de n8n o Zapier, tu backend — hagan lo que de otro modo harías a mano en el panel:
  • Programar llamadas de voz con IA a un número, ahora o a una hora determinada.
  • Crear contactos y meter leads en un pipeline de Salesflow.
  • Agendar citas en tu calendario y gestionar sus listas de espera.
  • Leer el historial de conversaciones de WhatsApp para reportes o sincronización.
Cada endpoint se documenta desde la misma fuente con la que corre la plataforma, así que los campos, ejemplos y errores que ves aquí son exactamente lo que la API acepta y devuelve.
Las páginas de cada endpoint (parámetros, esquemas, ejemplos y el panel Try it) se generan automáticamente y están en inglés. Esta introducción, la autenticación, los errores y las guías están en español.

Autenticación

Crea una clave de API en el panel y envíala en cada solicitud.

Errores

Las dos formas de respuesta de error y todos los error_code por endpoint.

Sincronizar conversaciones de WhatsApp

Descarga transcripciones de forma incremental y atribuye mensajes a agentes y personas.

Agendar citas de calendario

Todo lo que necesita una reserva y cómo conectarla con n8n.

​
URL base

Todas las rutas de esta referencia son relativas a la URL base y empiezan por /api/v2/public/. Usa el panel Try it de cualquier endpoint para enviar una solicitud real desde el navegador: elige el servidor, pega tu clave y completa los campos.

​
Convenciones

  • JSON de entrada y de salida. Envía Content-Type: application/json en las solicitudes con cuerpo.
  • Las marcas de tiempo son UTC en ISO 8601 (2026-06-30T15:39:33.482Z) salvo que un endpoint diga lo contrario: los endpoints de calendario reciben horas locales más un timezone IANA y devuelven UTC.
  • Los teléfonos conviene enviarlos en E.164 (+525512345678).
  • Los IDs son enteros y estables: el client_id que devuelve Create a client es el mismo que usan los endpoints de Salesflow, calendario y WhatsApp.

​
Versionado y compatibilidad

La API se versiona en la ruta (/api/v2/). Dentro de una versión los cambios son aditivos: pueden aparecer campos nuevos en las respuestas y aceptarse campos opcionales nuevos en las solicitudes. Ignora los campos que no reconozcas en lugar de fallar por ellos. Los cambios incompatibles salen bajo una versión nueva.

​
Límites

  • Hoy no se aplica límite de solicitudes. Pagina con responsabilidad (limit ≤ 50 en los listados) en lugar de pedir cargas máximas en bucle.
  • Solo lectura donde así se indica. Los endpoints de WhatsApp nunca modifican conversaciones, y los archivos multimedia no se descargan por la API: solo se devuelven sus metadatos.
  • Todavía no hay webhooks salientes. Consulta los listados con updated_after para ver cambios.

​
Qué puede ver una clave

Una clave pertenece a la cuenta en la que se creó. Si tu cuenta es una cuenta de socio con sub-cuentas (sedes, sucursales o negocios cliente), una clave cubre exactamente una sub-cuenta: aquella en la que estabas al crearla. Crea una clave dentro de cada sub-cuenta que integres. Más detalles en Autenticación.

​
¿Falta algo?

Leer y cancelar citas, los webhooks salientes y las cabeceras de límite de solicitudes todavía no forman parte de la API. Si tu integración necesita alguno, escribe a support@dialtu.com: nos ayuda a ordenar el roadmap.