Exportación CSV

Exportación de datos en formato CSV para análisis externo. Requiere rol de supervisor o superior.

Endpoints

Método	Endpoint	Descripción	Rol Mínimo
GET	/api/v1/export/calls.csv	Exportar llamadas	supervisor
GET	/api/v1/export/customers.csv	Exportar clientes	supervisor
GET	/api/v1/export/links.csv	Exportar enlaces de acceso	supervisor

---

Exportar Llamadas

Devuelve un archivo CSV con los datos de las llamadas.

GET /api/v1/export/calls.csv

Query Parameters

Parámetro	Tipo	Predeterminado	Descripción
date_from	string	30 días atrás	Fecha inicio (ISO 8601)
date_to	string	hoy	Fecha fin (ISO 8601)
status	string	-	Filtro por estado
department_id	uuid	-	Filtro por departamento

Ejemplo de Request

curl -X GET "https://voki.avanter.com.br/api/v1/export/calls.csv?date_from=2026-02-01&date_to=2026-02-18" \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -o calls.csv

Respuesta

Devuelve Content-Type: text/csv con el archivo:

id,status,department,attendant,customer_name,customer_email,duration,wait_time,rating,started_at,completed_at
1a2b3c4d-5e6f-7890-abcd-ef1234567890,completed,Suporte Técnico,João Silva,Carlos Ferreira,carlos@email.com,345,12,5,2026-02-15T14:30:00Z,2026-02-15T14:35:45Z

---

Exportar Clientes

GET /api/v1/export/customers.csv

Ejemplo de Request

curl -X GET "https://voki.avanter.com.br/api/v1/export/customers.csv" \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -o customers.csv

Respuesta

id,name,email,phone,document,call_count,last_call_at,created_at
2a3b4c5d-6e7f-8901-bcde-f23456789012,Carlos Ferreira,carlos@email.com,+5511999998888,123.456.789-00,5,2026-02-15T14:30:00Z,2026-01-10T09:00:00Z

---

Exportar Enlaces de Acceso

GET /api/v1/export/links.csv

Query Parameters

Parámetro	Tipo	Predeterminado	Descripción
status	string	-	Filtro por estado (active, used, expired, cancelled)
department_id	uuid	-	Filtro por departamento

Ejemplo de Request

curl -X GET "https://voki.avanter.com.br/api/v1/export/links.csv?status=used" \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -o links.csv

Respuesta

id,token,status,department,customer_name,customer_email,expires_at,used_at,created_at
6e7f8a9b-0c1d-2345-fghi-678901234567,abc123def456,used,Suporte Técnico,Carlos Ferreira,carlos@email.com,2026-02-25T23:59:59Z,2026-02-20T10:15:00Z,2026-02-18T10:00:00Z