curl -X POST https://beta.api-iobot-desarrollo.com/empresas/data-report/multi \
-H "Content-Type: application/json" \
-d '{
"businessId": 1,
"token": "TU_TOKEN",
"startDate": "2026-04-01T00:00:00.000Z",
"endDate": "2026-04-30T23:59:59.999Z",
"includeBusinesses": [1, 2]
}'
{
"data": [
{
"data": {
"id": 1,
"nombre": "Empresa Principal",
"img_wa": "https://example.com/logo.png",
"feature_flags": {
"currency": "HNL",
"currency_conversion": "USD",
"ad_account_for_report": 12
}
},
"conversaciones": 540,
"salesCount": 38,
"salesAmount": 95000,
"salesConversionRate": 7.04,
"quotationsCount": 112,
"quotationsAmount": 280000,
"qoutationConversionRate": 20.74,
"qoutationToSalesConversionRate": 33.93,
"averageTemperature": 7.2,
"averageAgentTemperature": 6.8,
"salesThatChatHasAnuncioIdCount": 25,
"salesThatChatHasAnuncioId": 62500,
"salesThatDoesntHaveAnuncioIdCount": 13,
"salesThatDoesntHaveAnuncioId": 32500,
"quotationsThatChatHasAnuncioIdCount": 70,
"quotationsThatChatHasAnuncioId": 175000,
"quotationsThatChatHasAnuncioIdAndSourceIsPdfCount": 30,
"quotationsThatChatHasAnuncioIdAndSourceIsPdf": 75000,
"quotationsThatChatHasAnuncioIdAndSourceIsMessageCount": 40,
"quotationsThatChatHasAnuncioIdAndSourceIsMessage": 100000,
"quotationsThatDoesntHaveAnuncioIdCount": 42,
"quotationsThatDoesntHaveAnuncioId": 105000,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsPdfCount": 18,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsPdf": 45000,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsMessageCount": 24,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsMessage": 60000,
"tags": [
{ "name": "Interesado", "count": 98 },
{ "name": "Seguimiento", "count": 54 }
],
"agentes": [
{
"agente": "María García",
"totalTickets": 120,
"completados": 95,
"cancelados": 10,
"pendientes": 8,
"proceso": 7,
"conversaciones": 540,
"ventas": 15,
"ventasAmount": 37500,
"cotizaciones": 40,
"cotizacionesAmount": 100000,
"empresa_id": 1
}
],
"adsBreakdown": [
{
"adId": "120201234567890",
"name": "Campaña Abril 2026",
"imageUrl": "https://example.com/ad.jpg",
"spend": 350.00,
"currency": "USD",
"sales": 12,
"salesAmount": 30000,
"quotations": 28,
"quotationsAmount": 70000,
"salesRecords": []
}
]
}
]
}
{
"message": "La empresa no tiene habilitado el reporte compartido"
}
{
"message": "Invalid API key"
}
Reporte Compartido
Obtener Reporte Compartido
Estadísticas comparativas de conversaciones, ventas y cotizaciones para un grupo de empresas
POST
/
empresas
/
data-report
/
multi
curl -X POST https://beta.api-iobot-desarrollo.com/empresas/data-report/multi \
-H "Content-Type: application/json" \
-d '{
"businessId": 1,
"token": "TU_TOKEN",
"startDate": "2026-04-01T00:00:00.000Z",
"endDate": "2026-04-30T23:59:59.999Z",
"includeBusinesses": [1, 2]
}'
{
"data": [
{
"data": {
"id": 1,
"nombre": "Empresa Principal",
"img_wa": "https://example.com/logo.png",
"feature_flags": {
"currency": "HNL",
"currency_conversion": "USD",
"ad_account_for_report": 12
}
},
"conversaciones": 540,
"salesCount": 38,
"salesAmount": 95000,
"salesConversionRate": 7.04,
"quotationsCount": 112,
"quotationsAmount": 280000,
"qoutationConversionRate": 20.74,
"qoutationToSalesConversionRate": 33.93,
"averageTemperature": 7.2,
"averageAgentTemperature": 6.8,
"salesThatChatHasAnuncioIdCount": 25,
"salesThatChatHasAnuncioId": 62500,
"salesThatDoesntHaveAnuncioIdCount": 13,
"salesThatDoesntHaveAnuncioId": 32500,
"quotationsThatChatHasAnuncioIdCount": 70,
"quotationsThatChatHasAnuncioId": 175000,
"quotationsThatChatHasAnuncioIdAndSourceIsPdfCount": 30,
"quotationsThatChatHasAnuncioIdAndSourceIsPdf": 75000,
"quotationsThatChatHasAnuncioIdAndSourceIsMessageCount": 40,
"quotationsThatChatHasAnuncioIdAndSourceIsMessage": 100000,
"quotationsThatDoesntHaveAnuncioIdCount": 42,
"quotationsThatDoesntHaveAnuncioId": 105000,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsPdfCount": 18,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsPdf": 45000,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsMessageCount": 24,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsMessage": 60000,
"tags": [
{ "name": "Interesado", "count": 98 },
{ "name": "Seguimiento", "count": 54 }
],
"agentes": [
{
"agente": "María García",
"totalTickets": 120,
"completados": 95,
"cancelados": 10,
"pendientes": 8,
"proceso": 7,
"conversaciones": 540,
"ventas": 15,
"ventasAmount": 37500,
"cotizaciones": 40,
"cotizacionesAmount": 100000,
"empresa_id": 1
}
],
"adsBreakdown": [
{
"adId": "120201234567890",
"name": "Campaña Abril 2026",
"imageUrl": "https://example.com/ad.jpg",
"spend": 350.00,
"currency": "USD",
"sales": 12,
"salesAmount": 30000,
"quotations": 28,
"quotationsAmount": 70000,
"salesRecords": []
}
]
}
]
}
{
"message": "La empresa no tiene habilitado el reporte compartido"
}
{
"message": "Invalid API key"
}
Retorna el reporte consolidado de métricas para un rango de fechas, agrupado por empresa. Incluye conversaciones, tasas de conversión a cotización y venta, montos totales con desglose por origen (Ads Meta vs. orgánico), rendimiento por agente y desglose por anuncio de Meta (si el negocio tiene
feature_flags.ad_account_for_report configurado).
El Reporte Compartido debe estar habilitado en el negocio raíz mediante feature_flags.aquatec_shared_report. Si no está configurado, el endpoint retorna 400.
Autenticación
Requiere el campotoken en el cuerpo o el encabezado x-api-key / x-iobot-key. Consulta Autenticación.
Cuerpo de la solicitud
number
required
ID del negocio raíz que tiene habilitado el Reporte Compartido.
string
Token de sesión del usuario (requerido si no se usa
x-api-key).string
required
Fecha de inicio del rango en formato ISO 8601 (ej.
"2026-04-01T00:00:00.000Z"). Filtra conversaciones, botones de registro (ventas/cotizaciones) y tickets.string
required
Fecha de fin del rango en formato ISO 8601 (ej.
"2026-04-30T23:59:59.999Z").number[]
IDs de empresas a incluir. Solo se incluyen IDs que pertenezcan al grupo configurado en
aquatec_shared_report. Si se omite, se incluyen todas las empresas del grupo.Respuesta
array
Lista de reportes, uno por empresa del grupo.
Show Objeto de reporte por empresa
Show Objeto de reporte por empresa
object
Datos completos del negocio (id, nombre, img_wa, feature_flags, etc.).
number
Total de conversaciones creadas en el período.
number
Cantidad de registros de venta cerrados.
number
Monto total de ventas en la moneda base del negocio.
number
Porcentaje de conversaciones que generaron una venta.
number
Cantidad de cotizaciones generadas.
number
Monto total de cotizaciones en la moneda base.
number
Porcentaje de conversaciones que generaron una cotización.
number
Porcentaje de cotizaciones que se convirtieron en venta.
number
Temperatura promedio de los chats según el resumen de IA.
number
Temperatura promedio asignada por los agentes.
number
Cantidad de ventas provenientes de anuncios de Meta.
number
Monto de ventas provenientes de anuncios de Meta.
number
Cantidad de ventas orgánicas (sin anuncio de Meta).
number
Monto de ventas orgánicas.
number
Cantidad de cotizaciones provenientes de anuncios de Meta.
number
Monto de cotizaciones de Meta.
number
Cotizaciones de Meta originadas en un PDF adjunto.
number
Monto de cotizaciones de Meta originadas en PDF.
number
Cotizaciones de Meta originadas en un mensaje del agente.
number
Monto de cotizaciones de Meta originadas en mensaje.
number
Cantidad de cotizaciones orgánicas.
number
Monto de cotizaciones orgánicas.
number
Cotizaciones orgánicas originadas en PDF.
number
Monto de cotizaciones orgánicas originadas en PDF.
number
Cotizaciones orgánicas originadas en mensaje.
number
Monto de cotizaciones orgánicas originadas en mensaje.
array
array
Rendimiento de agentes activos con
role_id: 5 del negocio.Show Objeto de agente
Show Objeto de agente
string
Nombre del agente.
number
Total de tickets en el período.
number
Tickets con estado
completado.number
Tickets con estado
cancelado.number
Tickets con estado
pendiente.number
Tickets con estado
proceso.number
Total de conversaciones del período para el negocio.
number
Cantidad de ventas registradas por el agente.
number
Monto total de ventas del agente en moneda base.
number
Cantidad de cotizaciones registradas por el agente.
number
Monto total de cotizaciones del agente en moneda base.
number
ID del negocio al que pertenece el agente.
array
Desglose por anuncio de Meta. Solo se incluye si
feature_flags.ad_account_for_report está configurado.Show Objeto de anuncio
Show Objeto de anuncio
string
ID del anuncio en Meta.
string | null
Nombre del anuncio obtenido de Meta Ads.
string | null
URL de la imagen o thumbnail del anuncio.
number | null
Gasto del anuncio en su moneda original (obtenido de Meta Ads Insights).
string | null
Moneda del gasto (ej.
"USD").number | null
Cantidad de ventas atribuidas al anuncio.
number | null
Monto de ventas atribuidas al anuncio en moneda base.
number | null
Cantidad de cotizaciones atribuidas al anuncio.
number | null
Monto de cotizaciones atribuidas en moneda base.
array
Registros individuales de venta (
BotonesRegistro) atribuidos al anuncio.curl -X POST https://beta.api-iobot-desarrollo.com/empresas/data-report/multi \
-H "Content-Type: application/json" \
-d '{
"businessId": 1,
"token": "TU_TOKEN",
"startDate": "2026-04-01T00:00:00.000Z",
"endDate": "2026-04-30T23:59:59.999Z",
"includeBusinesses": [1, 2]
}'
{
"data": [
{
"data": {
"id": 1,
"nombre": "Empresa Principal",
"img_wa": "https://example.com/logo.png",
"feature_flags": {
"currency": "HNL",
"currency_conversion": "USD",
"ad_account_for_report": 12
}
},
"conversaciones": 540,
"salesCount": 38,
"salesAmount": 95000,
"salesConversionRate": 7.04,
"quotationsCount": 112,
"quotationsAmount": 280000,
"qoutationConversionRate": 20.74,
"qoutationToSalesConversionRate": 33.93,
"averageTemperature": 7.2,
"averageAgentTemperature": 6.8,
"salesThatChatHasAnuncioIdCount": 25,
"salesThatChatHasAnuncioId": 62500,
"salesThatDoesntHaveAnuncioIdCount": 13,
"salesThatDoesntHaveAnuncioId": 32500,
"quotationsThatChatHasAnuncioIdCount": 70,
"quotationsThatChatHasAnuncioId": 175000,
"quotationsThatChatHasAnuncioIdAndSourceIsPdfCount": 30,
"quotationsThatChatHasAnuncioIdAndSourceIsPdf": 75000,
"quotationsThatChatHasAnuncioIdAndSourceIsMessageCount": 40,
"quotationsThatChatHasAnuncioIdAndSourceIsMessage": 100000,
"quotationsThatDoesntHaveAnuncioIdCount": 42,
"quotationsThatDoesntHaveAnuncioId": 105000,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsPdfCount": 18,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsPdf": 45000,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsMessageCount": 24,
"quotationsThatDoesntHaveAnuncioIdAndSourceIsMessage": 60000,
"tags": [
{ "name": "Interesado", "count": 98 },
{ "name": "Seguimiento", "count": 54 }
],
"agentes": [
{
"agente": "María García",
"totalTickets": 120,
"completados": 95,
"cancelados": 10,
"pendientes": 8,
"proceso": 7,
"conversaciones": 540,
"ventas": 15,
"ventasAmount": 37500,
"cotizaciones": 40,
"cotizacionesAmount": 100000,
"empresa_id": 1
}
],
"adsBreakdown": [
{
"adId": "120201234567890",
"name": "Campaña Abril 2026",
"imageUrl": "https://example.com/ad.jpg",
"spend": 350.00,
"currency": "USD",
"sales": 12,
"salesAmount": 30000,
"quotations": 28,
"quotationsAmount": 70000,
"salesRecords": []
}
]
}
]
}
{
"message": "La empresa no tiene habilitado el reporte compartido"
}
{
"message": "Invalid API key"
}