Conectar otras aplicaciones con la API de Daplox

La API de Daplox deja que otro sistema lea y escriba en tu cuenta sin que nadie copie datos a mano: un formulario de tu web que crea contactos, tu ERP que registra ventas, un flujo de Zapier, Make o n8n que mueve una oportunidad de etapa. Todo pasa por una clave que creas tú y que puedes apagar cuando quieras.

Crear una clave

1. 1
   Abre Configuración → API y webhooks

   Está en el grupo "Conectar aplicaciones". En el teléfono, elígela en el desplegable de secciones.
2. 2
   En la pestaña "Claves", pulsa "Nueva API Key"

   Ponle un nombre que diga dónde se usa (por ejemplo, "Zapier" o "ERP").
3. 3
   Elige los permisos

   "Solo lectura" consulta; "Lectura y escritura" además crea y modifica; "Lectura, escritura y administración" suma los webhooks y lo que cuesta dinero (solo la ve el dueño o un administrador).
4. 4
   Copia la clave y guárdala en un lugar seguro

   Se muestra una sola vez. Si la pierdes, rótala: la clave anterior deja de funcionar y verás la nueva.

Qué se puede hacer con la API

Lo que solo se hace desde el panel —facturación de tu suscripción, usuarios y contraseñas, seguridad, reinicio de la cuenta, la consola de la plataforma— no está disponible con una clave. Lo que cuesta dinero (difusiones de WhatsApp, campañas de correo, anuncios, compra de créditos) pide el permiso de administración.

Responsable de las actividades

Las actividades de POST /api/v1/public/activities pertenecen a la persona dueña de la clave. Actualmente POST y PATCH no admiten un campo para asignar otro responsable. Si deben aparecer bajo un compañero, ese compañero debe crear la clave desde su propia sesión y la integración debe usarla en X-API-Key, con permiso de escritura y acceso a CRM.

La primera petición

Todas las rutas parten de https://apig.daplox.com/api/v1/public y la clave va en la cabecera X-API-Key. Esta petición devuelve qué clave es, de qué empresa y con qué permisos:

curl https://apig.daplox.com/api/v1/public/me \
  -H "X-API-Key: dplx_..."

Reglas que conviene conocer

• Límites: 120 peticiones por minuto por clave y 600 por cuenta. Cada respuesta dice cuántas te quedan (X-RateLimit-Remaining); si te pasas, recibes 429 y la cabecera Retry-After dice cuánto esperar.
• Listados: devuelven hasta 100 elementos por página; para la siguiente se repite la petición con el cursor que viene en next_cursor.
• Sin duplicados: al crear, envía la cabecera Idempotency-Key. Si la petición se repite (por un corte de red, por ejemplo), Daplox devuelve la primera respuesta en vez de crear dos veces.
• Errores: siempre llegan con la misma forma y un código estable (por ejemplo, not_found o validation_error) que tu integración puede leer.
• Vencimiento: una clave vale un año desde que se crea. Rótala antes para no cortar la integración: los webhooks que creó pasan a la clave nueva.
• Si tu plan deja de incluir la API, las claves dejan de funcionar y los webhooks dejan de salir. Desde el panel puedes seguir viendo, apagando y borrando los destinos.

Dónde está la documentación completa

En Configuración → API y webhooks → Documentación está la guía técnica (autenticación, paginación, errores, límites, idempotencia, webhooks y cómo verificar su firma en curl, JavaScript y Python) y la referencia de cada ruta, generada de la especificación OpenAPI. El botón "Descargar OpenAPI (JSON)" baja ese archivo para importarlo en Postman o Insomnia, o para generar un cliente.

Descargar todas las guías para tu base de conocimiento

En Centro de ayuda → Descargar documentación puedes descargar todos los artículos públicos en español de la versión publicada. JSON conserva categorías, artículos, secciones y bloques; Markdown reúne el contenido en un documento de texto. Ambos incluyen una versión del contenido y los enlaces originales. Las imágenes se conservan como enlaces.

• Descargar la documentación
• Documento completo en JSON
• Documento completo en Markdown

Puedes consultar la misma URL de descarga desde tu integración sin una clave: contiene únicamente documentación pública. Guarda su ETag y envíalo como If-None-Match; 304 indica que no cambió y 200 entrega la versión para importar. El esquema OpenAPI de la API es una descarga separada que requiere tu sesión o X-API-Key; está en Configuración → API y webhooks → Documentación.