Integración de NICE

Punto final: /api/contacts/incontact/create

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

Método

GET

Autenticación

• Requerida: 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	Requerido	Descripción
incontactid	string	Sí	Identificador del sistema InContact (equivalente a ivrId)
queue	string	Sí	Código de cola usado para encontrar el origen del contacto
agent	string	Sí	Identificador del agente
ani	string	No	Identificación automática del número (número de teléfono de la persona que llama)
dnis	string	No	Servicio de identificación del número marcado (número que se marcó)
mediatype	string	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 se pueden configurar en el panel de control de CS Contact Admin
zipcode	string	No	Código postal
p	string	No	Parámetro adicional

Comportamiento

1. Validación:

   • Valida los campos obligatorios: incontactid, queue, agent

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

2. Resolución del origen del contacto:

   • Usa queue parámetro para encontrar el origen del contacto por código

   • Busca el origen del contacto en la organización del agente

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

3. Mapeo de tipo de medio:

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

     • '1' → Email

     • '2' → Fax

     • '3' → Chat

     • '4' → Call (predeterminado)

     • '5' → Correo de voz

     • '6' → Elemento de trabajo

     • '7' → SMS

     • '8' → Social

     • '9' → Digital

   • Predetermina a Call si mediatype no se reconoce

4. Creación del contacto:

   • Crea un contacto y

     • Mapea mediatype a medio

     • Mapea incontactid a ivrId

     • Almacena todos los parámetros de consulta en ivrData

     • Resuelve el origen del contacto desde 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

Solicitud de ejemplo

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

Respuesta de ejemplo

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