Fornecedores de Serviço

Fornecedores (Service Providers) permitem que empresas terceirizadas atendam chamadas na plataforma. Este guia explica o conceito e como configurar fornecedores.

Conceito

Em muitos cenários de atendimento, especialmente na área de saúde e consultoria, os profissionais que atendem as chamadas não são funcionários diretos da empresa, mas sim fornecedores de serviço (médicos, consultores, advogados, etc.).

O recurso de Fornecedores permite:

• Cadastrar empresas fornecedoras com seus dados (CNPJ, contato)
• Associar usuários (atendentes) a fornecedores
• Rastrear quais chamadas foram atendidas por fornecedores
• Separar relatórios por fornecedor

Fluxo de Configuração

1. Criar o Fornecedor

Requer papel 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. Criar Usuário para o Profissional

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. Associar Usuário ao Fornecedor

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. Adicionar ao Departamento

O profissional também precisa estar em pelo menos um departamento para receber chamadas:

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}"
  }'

Exemplo Completo

Empresa: Hospital ABC (tenant: hospital-abc)
│
├── Departamento: Telemedicina Cardiologia
│   ├── Dr. João (funcionário) ← Não associado a fornecedor
│   ├── Dr. Carlos (Clínica Silva) ← Fornecedor: Clínica Silva
│   └── Dra. Maria (Clínica Santos) ← Fornecedor: Clínica Santos
│
├── Fornecedor: Clínica Silva
│   ├── Dr. Carlos
│   └── Dr. Paulo
│
└── Fornecedor: Clínica Santos
    └── Dra. Maria

Permissões

Ação	Role Mínimo
Listar fornecedores	supervisor
Ver detalhes do fornecedor	supervisor
Criar/editar/excluir fornecedor	manager
Associar/desassociar usuários	manager

Endpoints Relacionados

• API de Fornecedores - CRUD completo
• API de Departamentos - Adicionar usuários a departamentos
• API de Usuários - Criar usuários para profissionais
• Analytics - Métricas por atendente (incluindo fornecedores)

Boas Práticas

1. Crie o fornecedor antes de criar os usuários associados
2. Use nomes descritivos para facilitar a identificação nos relatórios
3. Mantenha documentos atualizados (CNPJ) para compliance
4. Desative usuários de fornecedores que encerram contrato (em vez de excluir)
5. Monitore a performance de fornecedores via Analytics > Agents