Intégration NICE

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 ait un rôle CS Contact disposant de 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 du numéro automatique (numéro de téléphone de l'appelant)
dnis	chaîne	Non	Service d'identification du numéro composé (numéro 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) Des modifications ou des 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 requis : incontactid, 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. Mappage du type de média :

   • Mappe InContact 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 à média

     • Mappe incontactid à ivrId

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