Integración de Genesys

Punto de conexión: /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
ivrId	string	Sí	Identificador del sistema Genesys
queue	string	Sí	Código de cola utilizado para encontrar la fuente del contacto
agent	string	Sí	Identificador del agente
ani	string	No	Identificación automática de número (número de teléfono del llamante)
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. Valor 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
postalcode	string	No	Código postal
p	string	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:

   • Mapea mediatype códigos a MediumTypes enum:

     • '1' → Email

     • '2' → Fax

     • '3' → Chat

     • '4' → Call (predeterminado)

     • '5' → Voice Mail

     • '6' → Work Item

     • '7' → SMS

     • '8' → Social

     • '9' → Digital

   • Se establece como predeterminado en Call si mediatype no se reconoce

4. Creación de contacto:

   • Crea un contacto, y

     • Mapea 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 Encontrado
Ubicación: /contacts/770e8400-e29b-41d4-a716-446655440000