Intégration Genesys

Point de terminaison : /api/contacts/incontact/create

URL complète : {base_url}/api/contacts/incontact/create

Méthode

GET

Authentification

• Requise : Oui. Nécessite qu’un utilisateur soit connecté à CS Contact et possède un rôle CS Contact disposant de l’autorisation « Gérer les contacts »

Paramètres de requête

Paramètre	Type	Requis	Description
ivrId	string	Oui	Identifiant du système Genesys
queue	string	Oui	Code de file d’attente utilisé pour trouver la source du contact
agent	string	Oui	Identifiant de l’agent
ani	string	Non	Identification automatique du numéro (numéro de téléphone de l’appelant)
dnis	string	Non	Service d’identification du numéro composé (numéro qui a été composé)
mediatype	string	Non	Code de type de média InContact. Par défaut : '4' (Appel). Valeurs valides : '1' (E-mail), '2' (Fax), '3' (Chat), '4' (Appel), '5' (Messagerie vocale), '6' (Élément de travail), '7' (SMS), '8' (Social), '9' (Numérique) Les modifications ou ajouts à ce mappage peuvent être configurés dans le tableau de bord d’administration de CS Contact
postalcode	string	Non	Code postal
p	string	Non	Paramètre supplémentaire

Comportement

1. Validation :

   • Valide les champs requis : ivrId, queue, agent

   • Lance BadRequestException avec des erreurs de validation si les données sont invalides

2. Résolution de la source du contact :

   • Utilise queue paramètre pour trouver la source du contact par code

   • Recherche la source du contact dans l’organisation de l’agent

   • Définit source dans la charge utile si la source du contact est trouvée

3. Mappage du type de média :

   • Mappe mediatype les codes vers MediumTypes énumération :

     • '1' → E-mail

     • '2' → Fax

     • '3' → Chat

     • '4' → Appel (par défaut)

     • '5' → Messagerie vocale

     • '6' → Élément de travail

     • '7' → SMS

     • '8' → Social

     • '9' → Numérique

   • Par défaut à Appel si mediatype n’est pas reconnu

4. Création du contact :

   • Crée un contact, et

     • Mappe mediatype à média

     • Stocke tous les paramètres de requête dans ivrData

     • Résout la source du contact à partir du queue code

5. Réponse :

   • Type : Redirection HTTP (302)

   • Emplacement : /contacts/{contactId} (où {contactId} est l’UUID du contact créé)

   • Remarque : Il s’agit d’une réponse de redirection, pas de JSON

Exemple de requête

GET /api/contacts/genesys/create?mediatype=4&ivrId=IC-12345&queue=QUEUE-001&agent=AGENT-123&ani=5551234567&dnis=5559876543&postalcode=90000

Exemple de réponse

HTTP 302 Found
Emplacement : /contacts/770e8400-e29b-41d4-a716-446655440000