Este artículo está pensado para desarrolladores o para el responsable técnico de tu negocio. Si solo necesitas enviar documentos de forma automática sin programar, usa la acción Enviar documentos y contratos en un flujo de trabajo.
Para qué sirve
- Automatizar envíos: manda documentos desde herramientas externas o apps propias sin abrir Chateea.
- Aprovechar tus plantillas: crea un documento nuevo desde una plantilla y envíalo en una sola llamada.
- Mantener los datos sincronizados: consulta la lista de documentos y plantillas para reportes o para sincronizar con otros sistemas.
- Escalar tus procesos: combina los envíos por API con disparadores de flujos para recordatorios y seguimientos.
- Reducir errores: estandariza qué plantilla se usa y cómo se envía en todos tus sistemas.
Endpoints disponibles
Todos los endpoints trabajan con los datos de tu cuenta de Chateea: los documentos y plantillas que devuelven son los de esa cuenta.Enviar documento o enviar plantilla
- Enviar documento manda un documento que ya existe en Chateea. El documento debe estar creado antes de la llamada.
- Enviar plantilla crea un documento nuevo desde una plantilla y lo envía de inmediato. Es la mejor opción cuando necesitas un documento fresco para cada contacto y ya trabajas con plantillas estandarizadas.
Cómo empezar
1
Prepara tus documentos y plantillas
Confirma que los documentos o plantillas que vas a usar ya existen en tu cuenta de Chateea y que tienen los campos de combinación correctos.
2
Obtén tus credenciales
Crea un token de integración privada desde Configuración → Integraciones privadas. Es el método recomendado frente a las claves de API porque ofrece más seguridad y control de permisos.
3
Consulta la documentación de la API
Para conocer la URL base, el formato de cada petición y los parámetros de cada endpoint, escribe a soporte de Chateea en [email protected].
4
Prueba las llamadas
Usa una herramienta como Postman para hacer peticiones de prueba. Envía el token en el encabezado de autenticación y completa los parámetros que se piden (ID del documento, ID de la plantilla, ID de los contactos).
5
Valida las respuestas
Revisa el JSON que devuelve cada llamada y confirma que los documentos o plantillas se listan y se envían correctamente.
6
Integra y automatiza
Incorpora las llamadas en tu CRM, tus scripts o tu backend. Si quieres acciones posteriores, crea flujos de trabajo con el disparador de documentos y contratos (enviado, visto, firmado o completado).
7
Despliega de forma segura
Guarda tus tokens en un lugar seguro, renuévalos periódicamente y vigila el uso de la API para no superar los límites de peticiones.
Preguntas frecuentes
¿Qué endpoints incluye?
¿Qué endpoints incluye?
Listar documentos, enviar documento, listar plantillas y enviar plantilla.
¿Necesito permisos especiales?
¿Necesito permisos especiales?
Sí. Necesitas credenciales válidas, preferiblemente un token de integración privada con los permisos correspondientes a documentos y contratos.
¿Puedo usar la API en lugar de flujos de trabajo?
¿Puedo usar la API en lugar de flujos de trabajo?
Sí, cuando tu proceso empieza fuera de Chateea o necesita lógica personalizada. Para automatizaciones sin código dentro de Chateea, los flujos de trabajo suelen ser la mejor opción.
¿Puedo automatizar seguimientos después de un envío por API?
¿Puedo automatizar seguimientos después de un envío por API?
Sí. Combina los envíos por API con el disparador de documentos y contratos en un flujo para enviar recordatorios, notificar a tu equipo o mover oportunidades según el estado del documento.
¿Cómo pruebo la API sin riesgos?
¿Cómo pruebo la API sin riesgos?
Usa Postman u otro cliente de API con datos de prueba (por ejemplo, un contacto interno) antes de pasar a producción.
¿Puedo gestionar cualquier acción de documentos con la API?
¿Puedo gestionar cualquier acción de documentos con la API?
Los endpoints documentados cubren listar y enviar documentos y plantillas. Para confirmar la cobertura más reciente, escribe a soporte de Chateea en [email protected].
Artículos relacionados
Integraciones privadas
Crea tokens para conectar tus propias herramientas.
Cómo funcionan los flujos
Automatiza acciones tras el envío o la firma.