Intégration Genesys

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

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

Méthode

GET

Authentification

• Requis : Oui. Nécessite qu'un utilisateur soit connecté à CS Contact et qu'il dispose d'un rôle CS Contact ayant l'autorisation « Manage Contact »

Paramètres de requête

Paramètre	Type	Requis	Description
ivrId	chaîne	Oui	Identifiant du système Genesys
queue	chaîne	Oui	Code de file d'attente utilisé pour trouver la source du contact
agent	chaîne	Oui	Identifiant de l'agent
ani	chaîne	Non	Identification automatique du numéro (numéro de téléphone de l'appelant)
dnis	chaîne	Non	Service d'identification du numéro composé (numéro qui a été composé)
mediatype	chaîne	Non	Code de type de média InContact. Par défaut : '4' (Call). Valeurs valides : '1' (Email), '2' (Fax), '3' (Chat), '4' (Call), '5' (VoiceMail), '6' (WorkItem), '7' (SMS), '8' (Social), '9' (Digital) Les modifications ou ajouts à cette correspondance peuvent être configurés dans le tableau de bord CS Contact Admin
postalcode	chaîne	Non	Code postal/ZIP
p	chaîne	Non	Paramètre supplémentaire

Comportement

1. Validation :

   • Valide les champs requis : ivrId, queue, agent

   • Lance BadRequestException avec des erreurs de validation si invalide

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. Correspondance du type de média :

   • Mappe mediatype codes vers MediumTypes enum :

     • '1' → Email

     • '2' → Fax

     • '3' → Chat

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

     • '5' → Messagerie vocale

     • '6' → Work Item

     • '7' → SMS

     • '8' → Social

     • '9' → Digital

   • Par défaut sur Appel si mediatype n'est pas reconnu

4. Création de contact :

   • Crée un contact, et

     • Mappe mediatype vers média

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

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

5. Réponse :

   • Type : Redirection HTTP (302)

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

   • Remarque : Ceci est une réponse de redirection, pas du 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