🔑 Cómo obtener tu Token
- Ve a Configuración → Integraciones → Connect API.
- Genera un nuevo Token seleccionando los permisos que necesites.
- Reemplaza
CLIENGO_API_TOKENen los prompts por tu token.
📊 Dashboards y Reportes
1. Dashboard de Control de Facturación
Necesito un dashboard web para que mi equipo de administración controle la facturación de clientes.
Conéctate a la API de Cliengo con el header "Authorization: Bearer CLIENGO_API_TOKEN".
Consume GET https://connect.cliengo.com/v1/contacts y muestra una tabla ordenable con las columnas: Nombre, Email, Teléfono, Fecha de creación y un toggle "Factura Enviada".
Cada fila debe tener un botón "Revisar Chat" que haga GET a https://connect.cliengo.com/v1/conversations/contact/{contactId} y marque automáticamente el toggle si algún mensaje del chat contiene la palabra "factura" o "pagado".
Arriba del todo, quiero un resumen con el total de contactos, cuántos tienen factura enviada y cuántos faltan. Que se vea profesional y limpio.
(Documentación: https://developers.cliengo.com)
2. Reporte Semanal Automático por Email
Quiero un programa que todas las semanas descargue automáticamente los contactos nuevos de Cliengo y me mande un reporte por email.
Usa la API https://connect.cliengo.com/v1/contacts (Auth: Bearer CLIENGO_API_TOKEN).
Filtra solo los contactos creados en los últimos 7 días. Genera un archivo Excel con una hoja que tenga los datos de cada contacto (nombre, email, teléfono, fecha) y otra hoja con un gráfico de barras mostrando cuántos contactos entraron cada día de la semana.
Al final, envía ese Excel como adjunto a mi casilla de email. Si no hubo contactos nuevos esa semana, que mande un email avisando que no hubo actividad.
(Documentación: https://developers.cliengo.com)
3. Panel de Rendimiento del Equipo de Ventas
Necesito una aplicación web interna para que los gerentes de ventas vean las métricas de su equipo de un vistazo.
Llama a https://connect.cliengo.com/v1/contacts con Auth: Bearer CLIENGO_API_TOKEN.
Agrupa los contactos por la propiedad "assignedTo" (el vendedor asignado) y muestra un gráfico de dona con la distribución de leads por vendedor.
Debajo, quiero un ranking tipo tabla de posiciones que muestre qué vendedor tiene más contactos con estado "won" (ventas cerradas), y el tiempo promedio entre la creación del contacto y el cierre de la venta.
Incluye filtros por rango de fechas para poder comparar semanas o meses distintos.
(Documentación: https://developers.cliengo.com)
4. Sincronización Automática con Notion
Quiero un programa que mantenga sincronizados mis contactos de Cliengo con una Base de Datos de Notion, para que todo el equipo pueda verlos sin entrar al CRM.
Usa https://connect.cliengo.com/v1/contacts (Auth: Bearer CLIENGO_API_TOKEN) para traer los contactos.
Por cada contacto nuevo que aparezca, crea automáticamente una página en la base de datos de Notion con el nombre, email, teléfono y la fecha en que se creó el lead.
Antes de crear, verifica que el email no exista ya en Notion para evitar duplicados. Si el contacto ya existe, actualiza sus datos en vez de crear uno nuevo.
El programa debe poder correr de forma periódica (por ejemplo cada hora) sin intervención manual.
(Documentación: https://developers.cliengo.com)
5. Alertas de Ventas Cerradas en Slack
Quiero que cada vez que se cierre una venta en Cliengo, llegue automáticamente una notificación a un canal de Slack para que todo el equipo se entere.
El programa debe correr periódicamente y consultar https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) buscando contactos con estado "won" que se hayan actualizado recientemente.
Por cada venta nueva detectada, envía un mensaje al canal de Slack usando un Webhook URL con el nombre del cliente, su email, y un mensaje de celebración.
Lleva un registro de qué ventas ya fueron notificadas para no repetir alertas. Si pasan 24 horas sin ventas nuevas, manda un resumen diciendo que no hubo cierres.
(Documentación: https://developers.cliengo.com)
🤖 IA y Agentes de Soporte
6. Analizador de Sentimiento de Conversaciones
Necesito un programa que analice las conversaciones recientes de mis clientes y me diga si están contentos o enojados, para poder priorizar los casos urgentes.
Llama a https://connect.cliengo.com/v1/conversations (Auth: Bearer CLIENGO_API_TOKEN) para obtener las conversaciones recientes.
Por cada conversación, analiza los mensajes del cliente usando inteligencia artificial y clasifícalos como "Enojado", "Feliz" o "Neutral".
Si detecta un cliente enojado, resáltalo con una alerta visible que incluya el nombre y email del cliente. Al final, muestra un resumen con el porcentaje de cada categoría y una lista de los casos que necesitan atención urgente.
(Documentación: https://developers.cliengo.com)
7. Resumen Automático de Casos Largos
Mi equipo de soporte pierde mucho tiempo leyendo conversaciones largas para entender qué necesita el cliente. Necesito un programa que genere resúmenes automáticos.
Consulta las conversaciones en https://connect.cliengo.com/v1/conversations (Bearer CLIENGO_API_TOKEN) y filtra las que tengan más de 20 mensajes.
Para cada una de esas conversaciones largas, usa inteligencia artificial para generar un resumen de 3 puntos que explique: cuál es el problema del cliente, qué se le respondió, y si el caso quedó resuelto o pendiente.
Presenta los resultados en una lista clara con el nombre del contacto, la cantidad de mensajes y el resumen generado. Esto es para que un supervisor pueda revisar los casos del día en 5 minutos.
(Documentación: https://developers.cliengo.com)
8. Clasificador Automático de Intención de Compra
Quiero una aplicación web interna que ayude a mis vendedores a identificar rápidamente qué leads tienen intención real de compra y cuáles solo están curioseando.
Muestra una lista de contactos recientes traídos de https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN).
Al hacer clic en un contacto, trae su historial de conversación de https://connect.cliengo.com/v1/conversations/contact/{contactId} y usa inteligencia artificial para clasificar al lead como "Alta Intención de Compra", "Intención Media" o "Solo curioseando".
Muestra la clasificación con un badge de colores (verde, amarillo, rojo) y un breve justificativo de por qué se clasificó así. Permite ordenar toda la lista por nivel de intención para que los vendedores atiendan primero a los más calientes.
(Documentación: https://developers.cliengo.com)
9. Traductor de Conversaciones para Equipos Internacionales
Tengo agentes que hablan distintos idiomas y necesitan atender clientes en español. Necesito un visor de chats que traduzca automáticamente las conversaciones.
Consume las conversaciones de https://connect.cliengo.com/v1/conversations (Bearer CLIENGO_API_TOKEN).
Por cada mensaje, muestra el texto original y debajo la traducción al inglés (o al idioma que elija el agente en un selector). La interfaz debe parecerse a una app de chat moderna con burbujas de mensaje.
Incluye un indicador del idioma detectado en cada mensaje y la posibilidad de copiar la traducción al portapapeles. Esto es para un equipo distribuido en Latinoamérica, Estados Unidos y Europa.
(Documentación: https://developers.cliengo.com)
10. Generador de Preguntas Frecuentes desde Chats
Quiero generar automáticamente una sección de Preguntas Frecuentes (FAQ) para mi sitio web, usando las preguntas reales que hacen mis clientes en los chats.
Descarga las últimas 500 conversaciones de https://connect.cliengo.com/v1/conversations (Bearer CLIENGO_API_TOKEN).
Extrae todos los mensajes de los clientes que sean preguntas (las que contienen "?" o tienen estructura interrogativa). Agrúpalas por tema y encuentra las 15 preguntas más repetidas o similares entre sí.
Para cada pregunta frecuente, genera una respuesta sugerida basada en lo que los agentes respondieron en los chats. Exporta el resultado como un archivo con formato listo para publicar en un sitio web, con las preguntas organizadas por categoría.
(Documentación: https://developers.cliengo.com)
🔄 Automatizaciones y Sync (CRM/ERP)
11. Sincronización Continua con Google Sheets
Necesito que los contactos nuevos de Cliengo aparezcan automáticamente en una planilla de Google Sheets que comparto con mi equipo de marketing.
Usa https://connect.cliengo.com/v1/contacts con "Authorization: Bearer CLIENGO_API_TOKEN" para consultar los contactos.
El programa debe correr cada hora de forma automática. Cada vez que se ejecute, busca contactos con estado "new" que todavía no estén en la planilla y los agrega como filas nuevas con nombre, email, teléfono, y fecha de creación.
Si un contacto cambia de estado (por ejemplo de "new" a "won"), actualiza la fila correspondiente en Sheets. Nunca debe duplicar un contacto que ya existe en la planilla.
(Documentación: https://developers.cliengo.com)
12. Puente de Leads hacia tu CRM Externo
Quiero un programa que envíe automáticamente los leads nuevos de Cliengo a mi CRM externo (por ejemplo HubSpot, Salesforce, Zoho o cualquier otro que tenga API REST).
Haz GET a https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) filtrando los contactos creados en las últimas horas.
Mapea los campos de Cliengo a los campos del CRM destino: nombre del contacto, email, teléfono, y el canal por el que llegó (web, WhatsApp, etc.).
Si el contacto ya existe en el CRM destino (mismo email), actualiza sus datos en lugar de crear un duplicado. Respeta los límites de tasa (rate limit) de ambas APIs esperando entre peticiones si es necesario. Lleva un log de qué contactos se sincronizaron exitosamente y cuáles fallaron.
(Documentación: https://developers.cliengo.com)
13. Creador Automático de Tickets de Soporte
Necesito que cuando un contacto de Cliengo tenga el tag "soporte" o "queja", se cree automáticamente un ticket en mi sistema de gestión de tickets (Jira, Zendesk, Freshdesk, o el que uses).
Revisa periódicamente los contactos en https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) buscando los que tengan esos tags y no hayan sido procesados todavía.
Por cada contacto que califique, crea un ticket asignado al equipo técnico con el nombre del cliente, su email, teléfono, y en la descripción incluye el link al historial de conversación.
Si el contacto tiene el tag "urgente", marca el ticket como prioridad alta. Lleva un registro para no crear tickets duplicados del mismo contacto.
(Documentación: https://developers.cliengo.com)
14. Sincronización Bidireccional de Estados con CRM
Quiero mantener sincronizados los estados de mis leads entre Cliengo y mi CRM externo en ambas direcciones.
Toma los leads de Cliengo (https://connect.cliengo.com/v1/contacts, Bearer CLIENGO_API_TOKEN).
Si un lead se marca como ganado ("won") en el CRM externo, actualiza el contacto en Cliengo haciendo PATCH para cambiar su status a "closed". Y viceversa: si se cierra en Cliengo, actualiza el estado en el CRM.
El programa debe manejar conflictos (cuando un contacto se actualizó en ambos sistemas al mismo tiempo, gana el cambio más reciente). Debe correr de forma periódica y procesar múltiples contactos en paralelo para ser eficiente con bases de datos grandes.
(Documentación: https://developers.cliengo.com)
15. Exportador de Contactos a Plataforma de Email Marketing
Necesito un programa que corra periódicamente y exporte automáticamente los contactos nuevos de Cliengo a mi plataforma de email marketing (Mailchimp, Brevo, ActiveCampaign, o la que uses).
Obtiene los contactos de https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) que se crearon desde la última ejecución.
Por cada contacto, agrégalo como suscriptor a la lista o audiencia correspondiente con el tag "Cliengo_Lead" y el canal de origen (web, WhatsApp, etc.) como tag adicional.
Si el email ya existe como suscriptor, no lo dupliques sino actualiza sus tags. Genera un reporte al final con cuántos contactos se exportaron, cuántos ya existían y si hubo errores.
(Documentación: https://developers.cliengo.com)
📱 Mensajería y WhatsApp
Antes de usar estos prompts: las rutas de WhatsApp incluyen un
{channelId} (el canal HSM desde el que enviás). Obtenelo con
GET https://connect.cliengo.com/v1/whatsapp — devuelve tus canales con
capacidad WhatsApp; usá el channelId del que quieras. Reemplazá
{channelId} en /v1/whatsapp/{channelId}/templates y
/v1/whatsapp/{channelId}/template-messages.
16. Selector de Plantillas de WhatsApp para Vendedores
Necesito una aplicación web sencilla que mis vendedores puedan abrir desde el celular para enviar rápidamente mensajes de WhatsApp usando las plantillas aprobadas de la empresa.
La pantalla principal muestra la lista de plantillas disponibles consultando GET https://connect.cliengo.com/v1/whatsapp/{channelId}/templates (Bearer CLIENGO_API_TOKEN), con el nombre de cada plantilla y una vista previa del contenido.
Al tocar una plantilla, se abre un formulario donde el vendedor ingresa el número de teléfono del cliente y completa las variables del template (si las tiene). Al confirmar, envía el mensaje haciendo POST a https://connect.cliengo.com/v1/whatsapp/{channelId}/template-messages.
Muestra una confirmación visual cuando el mensaje se envía exitosamente y un historial de los últimos envíos realizados por ese vendedor.
(Documentación: https://developers.cliengo.com)
17. Recuperación Automática de Carritos Abandonados
Quiero un programa para mi tienda online que detecte automáticamente a los clientes que abandonaron el carrito y les envíe un mensaje de WhatsApp con un incentivo para completar la compra.
Lee los contactos de Cliengo (https://connect.cliengo.com/v1/contacts, Bearer CLIENGO_API_TOKEN) y busca los que tengan el tag "carrito_abandonado" y no tengan el tag "recuperado".
A cada uno de esos contactos, envíales una plantilla de WhatsApp con un descuento del 10% haciendo POST a https://connect.cliengo.com/v1/whatsapp/{channelId}/template-messages. Después de enviar, agrega el tag "recuperado" al contacto con PATCH para no volver a contactarlo.
Genera un reporte diario de cuántos mensajes de recuperación se enviaron y sugiere eliminar el tag "carrito_abandonado" de los contactos que llevan más de 30 días sin actividad.
(Documentación: https://developers.cliengo.com)
18. Felicitaciones Automáticas de Cumpleaños por WhatsApp
Quiero sorprender a mis clientes enviándoles automáticamente un mensaje de feliz cumpleaños por WhatsApp.
El programa debe correr todos los días temprano por la mañana y consultar https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) buscando contactos que tengan su fecha de cumpleaños almacenada en un campo personalizado.
Compara esa fecha con la fecha de hoy y, para los que cumplen años, envía una plantilla de WhatsApp con el saludo de cumpleaños haciendo POST a https://connect.cliengo.com/v1/whatsapp/{channelId}/template-messages.
Lleva un registro de qué felicitaciones ya se enviaron para no mandar duplicados si el programa se ejecuta más de una vez el mismo día. Opcionalmente, incluye un cupón de descuento especial de cumpleaños en el mensaje.
(Documentación: https://developers.cliengo.com)
19. Encuesta de Satisfacción Post-Venta
Necesito un sistema que automáticamente envíe una encuesta de satisfacción a los clientes una semana después de que se concretó su compra.
Busca contactos en https://connect.cliengo.com/v1/contacts (Auth: Bearer CLIENGO_API_TOKEN) que hayan sido marcados como "won" hace exactamente 7 días.
A cada uno de esos contactos, envíales una plantilla de WhatsApp (POST https://connect.cliengo.com/v1/whatsapp/{channelId}/template-messages) pidiéndoles que califiquen su experiencia del 1 al 5 y dejen un comentario opcional.
Marca a los contactos ya encuestados con un tag "encuesta_enviada" usando PATCH para no volver a contactarlos. Genera un reporte semanal con el promedio de calificaciones y la cantidad de respuestas recibidas.
(Documentación: https://developers.cliengo.com)
20. Envío Masivo de Plantillas para Eventos o Campañas
Necesito una herramienta con interfaz gráfica para que mi equipo de marketing pueda enviar plantillas de WhatsApp de forma masiva a una lista de contactos, por ejemplo para invitar a un evento o comunicar una promoción.
La herramienta debe permitir importar un archivo CSV con números de teléfono, o seleccionar contactos directamente desde Cliengo. Muestra las plantillas disponibles consultando GET https://connect.cliengo.com/v1/whatsapp/{channelId}/templates (Bearer CLIENGO_API_TOKEN) para que el usuario elija cuál enviar.
Al confirmar, envía la plantilla a toda la lista haciendo POST a https://connect.cliengo.com/v1/whatsapp/{channelId}/template-messages para cada destinatario, con un intervalo de 2 segundos entre envíos para respetar los límites de la plataforma.
Muestra una barra de progreso durante el envío y al finalizar un resumen con cuántos se enviaron exitosamente, cuántos fallaron y el motivo del error.
(Documentación: https://developers.cliengo.com)
👥 Gestión de Contactos y CRM
21. Limpieza Automática de Contactos Duplicados
Mi base de contactos tiene muchos duplicados y necesito limpiarla automáticamente.
Descarga todos los contactos paginando desde https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN).
Agrupa los contactos que tengan el mismo email. Para cada grupo de duplicados, conserva el registro más reciente (el que fue actualizado más recientemente) y marca los demás para eliminación.
Antes de eliminar, muestra un reporte previo con la lista de duplicados encontrados y cuáles se van a conservar. Si el usuario confirma, elimina los duplicados con DELETE /v1/contacts/{id}. Al final, imprime un resumen con cuántos contactos había, cuántos duplicados se encontraron y cuántos se eliminaron.
(Documentación: https://developers.cliengo.com)
22. Asignador Round-Robin de Leads para Equipos de Ventas
Necesito un programa que distribuya automáticamente los leads nuevos entre los vendedores de mi equipo de forma equitativa, usando una rotación circular (Round Robin).
El programa revisa periódicamente https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) buscando contactos que todavía no tengan un vendedor asignado.
Tiene configurada una lista con los IDs de los vendedores del equipo. Cada lead nuevo se asigna al siguiente vendedor de la lista haciendo PATCH /v1/contacts/{id}, y cuando llega al último vendedor vuelve al primero.
Si algún vendedor está marcado como ausente o de vacaciones, lo salta en la rotación. Registra cada asignación en un log para poder auditar la distribución y detectar si quedó desbalanceada.
(Documentación: https://developers.cliengo.com)
23. Enriquecimiento Automático de Datos de Contactos
Quiero que cada vez que entre un contacto nuevo a Cliengo, se enriquezca automáticamente con datos públicos de la empresa del cliente, para que mis vendedores tengan más contexto antes de llamar.
Lee los contactos nuevos de https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) que todavía no tengan el tag "enriquecido".
A partir del dominio del email del contacto, busca información pública de la empresa: nombre de la compañía, industria, tamaño aproximado, sitio web y logo. Puedes usar cualquier servicio de enriquecimiento de datos que tenga API pública.
Actualiza el contacto en Cliengo haciendo PATCH y guardando esos datos en campos personalizados. Agrega el tag "enriquecido" para no volver a procesarlo. Si no se encuentra información, agrega el tag "sin_datos_empresa".
(Documentación: https://developers.cliengo.com)
24. Tablero Kanban Visual de Pipeline de Ventas
Necesito un tablero visual estilo Kanban para gestionar mi pipeline de ventas, como un Trello pero conectado a los datos reales de Cliengo.
Crea columnas: "Nuevos", "Contactados", "En negociación", "Cerrados ganados" y "Cerrados perdidos".
Trae los leads de https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) y distribúyelos en las columnas según su estado actual.
Permite arrastrar y soltar las tarjetas de una columna a otra. Al soltar, hace automáticamente un PATCH a la API de Cliengo para actualizar el estado del contacto. Cada tarjeta debe mostrar el nombre del cliente, su teléfono, el canal por el que llegó y hace cuánto tiempo está en esa etapa. Incluye un contador de leads por columna en el encabezado.
(Documentación: https://developers.cliengo.com)
25. Buscador Instantáneo de Contactos
Necesito un buscador rápido tipo Spotlight (los que se abren con Ctrl+K o Cmd+K) que permita encontrar cualquier contacto de Cliengo al instante escribiendo su nombre, email o teléfono.
Al escribir, hace peticiones a https://connect.cliengo.com/v1/contacts?search={query} (Bearer CLIENGO_API_TOKEN) con un pequeño retardo entre teclas para no saturar la API.
Muestra los resultados instantáneamente debajo del buscador, con el nombre, email, teléfono y el estado del contacto. Al hacer clic en un resultado, muestra una ficha expandida con todos sus datos y un botón para abrir su perfil completo en Cliengo.
Debe funcionar embebido dentro de cualquier página web, activarse con un atajo de teclado, y cerrarse con Escape. Que se vea limpio y profesional.
(Documentación: https://developers.cliengo.com)
🛠️ Mantenimiento y Webhooks
26. Validador y Limpieza de Números de Teléfono
Necesito un programa de mantenimiento que valide todos los números de teléfono de mis contactos y marque los que son inválidos, para que mi equipo no pierda tiempo llamando a números que no existen.
Trae los contactos del día de https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN).
Por cada contacto que tenga teléfono, verifica si el número tiene un formato internacional válido (código de país, cantidad correcta de dígitos, etc.).
Los contactos con números inválidos reciben el tag "numero_invalido" mediante PATCH. Los que tienen un formato corregible (por ejemplo le falta el código de país), intenta corregirlo automáticamente y actualiza el campo. Al final, genera un reporte con cuántos teléfonos se validaron, cuántos eran inválidos y cuántos se pudieron corregir.
(Documentación: https://developers.cliengo.com)
27. Receptor de Webhooks con Almacenamiento Local
Necesito un servidor web simple que reciba webhooks de Cliengo cada vez que se crea un nuevo contacto, y los guarde en una base de datos local para procesarlos después.
Crea un endpoint POST /webhook que reciba el payload de Cliengo.
Verifica que el payload tenga la estructura correcta de un evento de nuevo contacto (debe incluir al menos nombre, email o teléfono). Si la estructura es válida, guárdalo en una base de datos local con un timestamp de cuándo se recibió.
Si el payload es inválido o está vacío, responde con un error 400. Incluye un endpoint GET /webhook/recent que muestre los últimos 50 webhooks recibidos para poder verificar que está funcionando. Agrega logs claros de cada webhook recibido para facilitar el debugging.
(Documentación: https://developers.cliengo.com)
28. Monitor de Disponibilidad y Latencia de la API
Quiero un dashboard para el equipo técnico que monitoree en tiempo real si la API de Cliengo está respondiendo correctamente y con qué velocidad.
Cada 30 segundos, haz una llamada a https://connect.cliengo.com/health y mide cuánto tarda en responder.
Muestra un gráfico de líneas en tiempo real con la latencia de las últimas 2 horas. Si la respuesta tarda más de 2 segundos o el status no es 200, muestra una alerta roja visible.
Incluye indicadores del uptime (porcentaje de tiempo que estuvo disponible), la latencia promedio, y la latencia máxima del período. Si se detecta una caída, guarda el evento con timestamp para poder revisar el historial después.
(Documentación: https://developers.cliengo.com)
29. Etiquetado Automático por Idioma del Cliente
Mi empresa atiende clientes en varios idiomas y necesito que cada contacto se etiquete automáticamente con su idioma para derivarlo al equipo correcto.
Por cada contacto nuevo que aparezca en https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) que no tenga todavía un tag de idioma, busca su primera conversación.
Lee los primeros mensajes del cliente en esa conversación y detecta automáticamente en qué idioma escribió. Añade un tag al contacto como "lang:es", "lang:en", "lang:pt", etc. mediante PATCH, para que el sistema de routing derive al agente que habla ese idioma.
Si no se puede determinar el idioma con confianza (por ejemplo mensajes muy cortos como "hola"), agrega el tag "lang:indefinido" para que un humano lo revise. Genera un reporte semanal con la distribución de idiomas detectados.
(Documentación: https://developers.cliengo.com)
30. Pipeline ETL para Análisis de Datos en Data Warehouse
Necesito extraer todos los datos de contactos y conversaciones de Cliengo y cargarlos en un data warehouse (BigQuery, Redshift, Snowflake, o el que uses) para poder hacer análisis avanzados con mi equipo de datos.
Extrae todos los contactos y conversaciones de la API de Cliengo (https://connect.cliengo.com/v1/contacts y https://connect.cliengo.com/v1/conversations, Bearer CLIENGO_API_TOKEN) manejando correctamente la paginación para no perder registros.
Transforma los datos a un formato tabular: una tabla de contactos (con todos sus campos aplanados) y una tabla de mensajes (un registro por mensaje, con el ID de la conversación como referencia).
Carga los datos en el data warehouse, haciendo upsert para no duplicar registros en ejecuciones sucesivas. El proceso debe poder correr diariamente de forma automática y solo procesar los datos nuevos o modificados desde la última ejecución. Incluye logs de cuántos registros se procesaron y si hubo errores.
(Documentación: https://developers.cliengo.com)
📈 Métricas de Agentes y Conversaciones
31. Reporte de Gestión por Agente
Necesito un reporte que muestre, para cada agente de mi equipo, cuántas conversaciones intervino y cuántas tiene asignadas en un rango de fechas, para evaluar la carga de trabajo y la gestión.
Para cada agente, traé las conversaciones que intervino con https://connect.cliengo.com/v1/conversations?agent=AGENT_ID&fromDate=...&toDate=... y las asignadas con el parámetro preAssigned=AGENT_ID (Bearer CLIENGO_API_TOKEN), manejando la paginación.
Por cada agente mostrá: total de conversaciones intervenidas, total asignadas, y cuántas siguen abiertas vs cerradas.
Generá una tabla ordenada por cantidad de intervenciones y un gráfico de barras comparando los agentes. Permití filtrar por canal (WhatsApp, Web, etc.).
(Documentación: https://developers.cliengo.com)
32. Métricas de SLA: Tiempo hasta Primera Intervención Humana
Quiero medir el SLA de atención de mi equipo: cuánto tarda en promedio un humano en intervenir una conversación después de que entra, y el tiempo hasta el último mensaje del agente.
Traé las conversaciones del rango con https://connect.cliengo.com/v1/conversations?condition=intervened&fromDate=...&toDate=... (Bearer CLIENGO_API_TOKEN), paginando.
Por cada conversación, calculá la "fecha y hora de intervención humana" como el firstMessageAt del primer participante de tipo user o externalOperator dentro del array participants, y la "fecha y hora del último mensaje del agente" como el lastMessageAt de ese participante. Restá la fecha de creación de la conversación (createdAt) para obtener el tiempo hasta la primera intervención.
Mostrá: tiempo promedio y mediana hasta la primera intervención humana, distribución por tramos (menos de 5 min, 5-30 min, más de 30 min), y un ranking de agentes por velocidad de respuesta. Marcá en rojo las conversaciones que superaron tu objetivo de SLA.
(Documentación: https://developers.cliengo.com)
33. Listado de Conversaciones Intervenidas por un Agente
Necesito una vista simple donde un supervisor elija un agente y vea todas las conversaciones que ese agente intervino, con la fecha de su primera y última intervención, para hacer seguimiento de casos.
Pedí al usuario un AGENT_ID (o mostrá la lista de usuarios desde https://connect.cliengo.com/v1/users). Luego traé las conversaciones intervenidas con https://connect.cliengo.com/v1/conversations?agent=AGENT_ID (Bearer CLIENGO_API_TOKEN), paginando.
Por cada conversación mostrá: nombre del visitante, canal, estado, fecha de intervención humana (el firstMessageAt más temprano entre los participantes con type user o externalOperator), fecha del último mensaje del agente (el lastMessageAt más reciente entre esos mismos participantes humanos) y los tags. Permití ordenar por fecha de última actividad y exportar la lista a CSV.
(Documentación: https://developers.cliengo.com)
🎯 Origen y Atribución de Leads
34. Reporte de Leads por Origen: Orgánico vs Pago
Necesito un reporte que clasifique mis leads según su origen de adquisición (orgánico vs pago) y su canal, para saber qué canales me traen mejores resultados.
Traé las conversaciones de un rango con https://connect.cliengo.com/v1/conversations?fromDate=...&toDate=... (Bearer CLIENGO_API_TOKEN), manejando la paginación.
Clasificá cada lead como PAGO si tiene gclid, o si utmMedium es cpc/paid/ads, o si utmSource es una plataforma de ads (google, facebook, instagram con medium pago); en caso contrario, ORGÁNICO. Identificá el canal con el campo channel (WhatsApp, Web, Instagram, Facebook).
Generá una tabla con la cantidad de leads por origen (orgánico/pago) y por canal, y un gráfico de torta. Mostrá el porcentaje de cada categoría tipo "Meta Ads (Click to WhatsApp)", "WhatsApp Orgánico", "Formulario Web Orgánico", etc., combinando channel + utmSource + utmMedium.
(Documentación: https://developers.cliengo.com)
35. Efectividad de Canales: Origen vs Conversión
Quiero medir la efectividad de cada canal cruzando el origen del lead con la etapa de conversión que alcanzó, para decidir dónde invertir mi presupuesto.
Traé los contactos con https://connect.cliengo.com/v1/contacts (Bearer CLIENGO_API_TOKEN) y sus conversaciones de https://connect.cliengo.com/v1/conversations, paginando ambos.
Por cada lead determiná su origen (orgánico vs pago, usando gclid/utmMedium/utmSource) y su canal (entryMethod). Cruzá ese origen con la etapa de conversión: usá el status del contacto (new, active, client, long_term) como proxy de avance, y marcá los leads sin respuesta (sin intervención humana) y los convertidos en cliente.
Generá una matriz origen × etapa con: total de leads, leads sin respuesta, oportunidades (active) y ventas (client). Calculá la tasa de conversión por origen y canal, y rankeá los canales por efectividad.
(Documentación: https://developers.cliengo.com)
36. Análisis de Campañas UTM
Necesito analizar el rendimiento de mis campañas de marketing identificadas por parámetros UTM, para saber qué campaña genera más y mejores leads.
Traé las conversaciones filtrando por campaña con https://connect.cliengo.com/v1/conversations?utmSource=...&utmMedium=...&utmCampaign=... (Bearer CLIENGO_API_TOKEN). Para una vista global, traé todas y agrupalas por la combinación de utmSource, utmMedium y utmCampaign.
Por cada campaña mostrá: cantidad de conversaciones generadas, cuántas tuvieron intervención humana, cuántas llegaron a cliente, y el canal predominante. Ordená por volumen y por tasa de conversión.
Generá un dashboard con una tabla de campañas y gráficos comparativos. Permití filtrar por rango de fechas.
(Documentación: https://developers.cliengo.com)
📥 Inbox — Base Dinámica
37. Base de Inbox (conversaciones + etapas + etiquetas + valor + puntuación + agentes)
Quiero un dashboard base de Inbox del que pueda partir para cualquier análisis. Traé de forma dinámica TODA la información más usada de las conversaciones y dejala lista para filtrar, graficar y profundizar después.
Fuente: API de Cliengo Connect (Bearer CLIENGO_API_TOKEN). Documentación: https://developers.cliengo.com
Datos a traer por conversación (GET https://connect.cliengo.com/v1/conversations):
- Conversación: id, visitorName, channel, status, createdAt, lastMessageAt.
- Etapa de inbox: viene como phaseId (un ID). Resolvé el nombre legible con GET https://connect.cliengo.com/v1/phases (mapeá phaseId -> name, ej. "Nuevos", "Cotizados", "Pedidos").
- Etiquetas del usuario/bot: usá el array operatorTags (cada item tiene tagName y source: human/chatbot/ai). NO uses el array `tags` plano para mostrar, porque mezcla etiquetas internas de Cliengo (posted_*, fired_*, is_intervened, was_intervened, automatic_transfer, external_robot, post_lead, no_lead); si lo usás, filtralas.
- Valor monetario: campo amount de la conversación (puede ser null/0).
- Asignación e intervención: assignedTo (asignado), persistentLastOperator (último agente que intervino).
- Puntuación del lead (estrellas 1-5): NO está en la conversación, está en el contacto. Traé los contactos con GET https://connect.cliengo.com/v1/contacts y cruzá conversation.contactId con contact.id para leer contact.rating.
Consideraciones técnicas (importantes):
- El listado de conversaciones devuelve un objeto bajo `data` indexado por ID, no un arreglo: recorrelo con Object.values(resp.data).
- limit máximo 100 por request: paginá con offset (o page) de a 100 hasta traer todo el rango. Filtrá por fecha con createdAt.
- Validá que los arrays existan antes de iterarlos. Ante 429 (rate limit), reintentá con backoff.
Entregable: un dashboard con KPIs (total de conversaciones, valor monetario total) y vistas por etapa, por etiqueta (solo de usuario/bot), por agente, por origen y por puntuación. Dejá los filtros globales (rango de fechas, etapa, etiqueta, agente) para poder ajustar la base según cada necesidad.
(Documentación: https://developers.cliengo.com)
38. Valor Monetario por Etapa de Inbox
Necesito ver cuánto dinero hay en cada etapa de mi inbox, para enfocarme en las etapas con más valor (por ejemplo "Pedidos").
Traé todas las conversaciones de un rango con https://connect.cliengo.com/v1/conversations (Bearer CLIENGO_API_TOKEN), paginando de a 100 con offset y recordando que la respuesta es un objeto bajo `data` indexado por ID (recorrelo con Object.values).
Por cada conversación tomá el campo amount (valor monetario; tratá null/0 como cero) y su phaseId. Resolvé el nombre de la etapa con GET https://connect.cliengo.com/v1/phases (phaseId -> name).
Mostrá un gráfico de barras con la suma de amount por etapa y un KPI con el total. Resaltá la etapa que elija el usuario (ej. "Pedidos") y, al hacer clic, listá sus conversaciones ordenadas por amount de mayor a menor.
(Documentación: https://developers.cliengo.com)