Integración NICE

Punto de enlace: /api/contacts/incontact/create

URL completa: {base_url}/api/contacts/incontact/create

Método

GET

Autenticación

• Requerido: Sí. Requiere que un usuario haya iniciado sesión en CS Contact y tenga un rol de CS Contact que tenga el permiso "Manage Contact"

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
incontactid	cadena	Sí	Identificador del sistema InContact (equivalente a ivrId)
queue	cadena	Sí	Código de cola utilizado para encontrar la fuente del contacto
agent	cadena	Sí	Identificador del agente
ani	cadena	No	Identificación automática de número (número de teléfono del llamante)
dnis	cadena	No	Servicio de identificación del número marcado (número que fue marcado)
mediatype	cadena	No	Código de tipo de medio de InContact. Predeterminado: '4' (Call). Valores válidos: '1' (Email), '2' (Fax), '3' (Chat), '4' (Call), '5' (VoiceMail), '6' (WorkItem), '7' (SMS), '8' (Social), '9' (Digital) Los cambios o adiciones a este mapeo pueden configurarse en el Panel de administración de CS Contact
zipcode	cadena	No	Código postal/ZIP
p	cadena	No	Parámetro adicional

Comportamiento

1. Validación:

   • Valida campos obligatorios: incontactid, queue, agent

   • Lanza BadRequestException con errores de validación si es inválido

2. Resolución de la fuente de contacto:

   • Usa queue parámetro para encontrar la fuente del contacto por código

   • Busca la fuente de contacto en la organización del agente

   • Establece source en la carga útil si se encuentra la fuente del contacto

3. Mapeo de tipo de medio:

   • Mapea los mediatype códigos de InContact a MediumTypes enum:

     • '1' → Email

     • '2' → Fax

     • '3' → Chat

     • '4' → Call (predeterminado)

     • '5' → Buzón de voz

     • '6' → Work Item

     • '7' → SMS

     • '8' → Social

     • '9' → Digital

   • Por defecto a Call si mediatype no se reconoce

4. Creación de contacto:

   • Crea un Contact, y

     • Mapea mediatype a medio

     • Mapea incontactid a ivrId

     • Almacena todos los parámetros de consulta en ivrData

     • Resuelve la fuente del contacto a partir de queue código

5. Respuesta:

   • Tipo: Redirección HTTP (302)

   • Ubicación: /contacts/{contactId} (donde {contactId} es el UUID del contacto creado)

   • Nota: Esta es una respuesta de redirección, no JSON

Ejemplo de solicitud

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

Ejemplo de respuesta

HTTP 302 Found
Ubicación: /contacts/770e8400-e29b-41d4-a716-446655440000