Proveedores de Servicio

Los proveedores (Service Providers) permiten que empresas terceras atiendan llamadas en la plataforma. Esta guía explica el concepto y cómo configurar proveedores.

Concepto

En muchos escenarios de atención, especialmente en el área de salud y consultoría, los profesionales que atienden las llamadas no son empleados directos de la empresa, sino proveedores de servicio (médicos, consultores, abogados, etc.).

El recurso de Proveedores permite:

• Registrar empresas proveedoras con sus datos (CNPJ, contacto)
• Asociar usuarios (agentes) a proveedores
• Rastrear qué llamadas fueron atendidas por proveedores
• Separar informes por proveedor

Flujo de Configuración

1. Crear el Proveedor

Requiere rol de manager.

curl -X POST https://voki.avanter.com.br/api/v1/providers \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -H "Content-Type: application/json" \
  -d '{
    "service_provider": {
      "name": "Clínica Dr. Silva",
      "document": "11.222.333/0001-44",
      "email": "contato@clinicasilva.com.br",
      "phone": "+5511977776666"
    }
  }'

2. Crear Usuario para el Profesional

curl -X POST https://voki.avanter.com.br/api/v1/users \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -H "Content-Type: application/json" \
  -d '{
    "user": {
      "name": "Dr. Carlos Silva",
      "email": "carlos@clinicasilva.com.br",
      "password": "senhaTemporaria123",
      "role": "attendant"
    }
  }'

3. Asociar Usuario al Proveedor

curl -X POST https://voki.avanter.com.br/api/v1/providers/{provider_id}/users \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "{user_id}"
  }'

4. Agregar al Departamento

El profesional también necesita estar en al menos un departamento para recibir llamadas:

curl -X POST https://voki.avanter.com.br/api/v1/departments/{department_id}/users \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "{user_id}"
  }'

Ejemplo Completo

Empresa: Hospital ABC (tenant: hospital-abc)
│
├── Departamento: Telemedicina Cardiología
│   ├── Dr. João (empleado) ← No asociado a proveedor
│   ├── Dr. Carlos (Clínica Silva) ← Proveedor: Clínica Silva
│   └── Dra. Maria (Clínica Santos) ← Proveedor: Clínica Santos
│
├── Proveedor: Clínica Silva
│   ├── Dr. Carlos
│   └── Dr. Paulo
│
└── Proveedor: Clínica Santos
    └── Dra. Maria

Permisos

Acción	Rol Mínimo
Listar proveedores	supervisor
Ver detalles del proveedor	supervisor
Crear/editar/eliminar proveedor	manager
Asociar/desasociar usuarios	manager

Endpoints Relacionados

• API de Proveedores - CRUD completo
• API de Departamentos - Agregar usuarios a departamentos
• API de Usuarios - Crear usuarios para profesionales
• Analytics - Métricas por agente (incluyendo proveedores)

Buenas Prácticas

1. Cree el proveedor antes de crear los usuarios asociados
2. Use nombres descriptivos para facilitar la identificación en los informes
3. Mantenga los documentos actualizados (CNPJ) para cumplimiento normativo
4. Desactive usuarios de proveedores que finalizan contrato (en lugar de eliminarlos)
5. Monitoree el rendimiento de proveedores vía Analytics > Agents