Fournisseurs de Services

Les fournisseurs (Service Providers) permettent à des entreprises tierces de prendre en charge des appels sur la plateforme. Ce guide explique le concept et comment configurer les fournisseurs.

Concept

Dans de nombreux scénarios de service client, notamment dans les domaines de la santé et du conseil, les professionnels qui prennent les appels ne sont pas des employés directs de l'entreprise, mais des fournisseurs de services (médecins, consultants, avocats, etc.).

La fonctionnalité Fournisseurs permet de :

• Enregistrer des entreprises fournisseurs avec leurs données (CNPJ, contact)
• Associer des utilisateurs (agents) à des fournisseurs
• Suivre quels appels ont été pris en charge par des fournisseurs
• Séparer les rapports par fournisseur

Flux de Configuration

1. Créer le Fournisseur

Nécessite le rôle 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": "Clinique Dr. Silva",
      "document": "11.222.333/0001-44",
      "email": "contact@cliniquesilva.com.br",
      "phone": "+5511977776666"
    }
  }'

2. Créer un Utilisateur pour le Professionnel

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@cliniquesilva.com.br",
      "password": "motDePasseTemporaire123",
      "role": "attendant"
    }
  }'

3. Associer l'Utilisateur au Fournisseur

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. Ajouter au Département

Le professionnel doit également être dans au moins un département pour recevoir des appels :

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

Exemple Complet

Entreprise : Hôpital ABC (tenant : hospital-abc)
│
├── Département : Télémédecine Cardiologie
│   ├── Dr. João (employé) ← Non associé à un fournisseur
│   ├── Dr. Carlos (Clinique Silva) ← Fournisseur : Clinique Silva
│   └── Dra. Maria (Clinique Santos) ← Fournisseur : Clinique Santos
│
├── Fournisseur : Clinique Silva
│   ├── Dr. Carlos
│   └── Dr. Paulo
│
└── Fournisseur : Clinique Santos
    └── Dra. Maria

Permissions

Action	Rôle Minimum
Lister les fournisseurs	supervisor
Voir les détails d'un fournisseur	supervisor
Créer/modifier/supprimer un fournisseur	manager
Associer/dissocier des utilisateurs	manager

Endpoints Associés

• API des Fournisseurs - CRUD complet
• API des Départements - Ajouter des utilisateurs aux départements
• API des Utilisateurs - Créer des utilisateurs pour les professionnels
• Analytics - Métriques par agent (y compris les fournisseurs)

Bonnes Pratiques

1. Créez le fournisseur avant de créer les utilisateurs associés
2. Utilisez des noms descriptifs pour faciliter l'identification dans les rapports
3. Maintenez les documents à jour (CNPJ) pour la conformité
4. Désactivez les utilisateurs des fournisseurs qui mettent fin à leur contrat (au lieu de les supprimer)
5. Surveillez la performance des fournisseurs via Analytics > Agents