Intégration NICE

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 qu’il dispose d’un rôle CS Contact avec l’autorisation « Manage Contact »

Paramètres de requête

Paramètre	Type	Requis	Description
incontactid	chaîne	Oui	Identifiant système InContact (équivalent à ivrId)
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' (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 CS Contact Admin
zipcode	chaîne	Non	Code postal
p	chaîne	Non	Paramètre supplémentaire

Comportement

1. Validation :

   • Valide les champs obligatoires : incontactid, queue, agent

   • Lève BadRequestException avec des erreurs de validation si la valeur est 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. Mappage du type de média :

   • Mappe les codes InContact mediatype vers MediumTypes enum :

     • '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édium

     • Mappe incontactid à ivrId

     • 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 : Il s’agit d’une réponse de redirection, pas de JSON

Exemple de requête

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

Exemple de réponse

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