Integración con Genesys

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	Requerido	Descripción
ivrId	cadena	Sí	Identificador del sistema Genesys
queue	cadena	Sí	Código de la cola usado 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 de 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 se pueden configurar en el Panel de administración de CS Contact
postalcode	cadena	No	Código postal/ZIP
p	cadena	No	Parámetro adicional

Comportamiento

1. Validación:

   • Valida los campos requeridos: ivrId, queue, agent

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

2. Resolución de la fuente del contacto:

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

   • Busca la fuente del 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:

   • Asocia mediatype códigos a MediumTypes enum:

     • '1' → Correo electrónico

     • '2' → Fax

     • '3' → Chat

     • '4' → Llamada (predeterminado)

     • '5' → Correo de voz

     • '6' → Elemento de trabajo

     • '7' → SMS

     • '8' → Social

     • '9' → Digital

   • Predetermina a Llamada si mediatype no se reconoce

4. Creación de contacto:

   • Crea un Contact, y

     • Asocia mediatype a medio

     • Almacena todos los parámetros de consulta en ivrData

     • Resuelve la fuente 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

Ejemplo de solicitud

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

Ejemplo de respuesta

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