> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dialtu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Qué hace la API pública de Dialtu, dónde vive y cómo se comporta

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.

<Note>
  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.
</Note>

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/es/api-reference/autenticacion">
    Crea una clave de API en el panel y envíala en cada solicitud.
  </Card>

  <Card title="Errores" icon="triangle-exclamation" href="/es/api-reference/errores">
    Las dos formas de respuesta de error y todos los `error_code` por endpoint.
  </Card>

  <Card title="Sincronizar conversaciones de WhatsApp" icon="whatsapp" href="/es/api-reference/guias/sincronizar-conversaciones-whatsapp">
    Descarga transcripciones de forma incremental y atribuye mensajes a agentes y personas.
  </Card>

  <Card title="Agendar citas de calendario" icon="calendar-check" href="/es/api-reference/guias/citas-de-calendario">
    Todo lo que necesita una reserva y cómo conectarla con n8n.
  </Card>
</CardGroup>

## URL base

| Entorno    | URL base                     |
| ---------- | ---------------------------- |
| Producción | `https://api.dialtu.com`     |
| Staging    | `https://api.stg.dialtu.com` |

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](/es/api-reference/autenticacion).

## ¿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](mailto:support@dialtu.com): nos ayuda a ordenar el roadmap.