Pure Cloud Get a Contact
Nombre del elemento: Pure Cloud Get a Contact
Categoría: Genesys Cloud
Descripción: Funcionalidad avanzada, posee nombre personalizable y un grupo de parámetros configurables para consultar contactos de campañas outbound en Genesys cloud.
Funcionalidad: Permite consultar un contacto de campañas outbound en Genesy Cloud, obteniendo todos los datos referentes a esas listas y detalles de los registros a través de una integración con el API REST de Genesys Cloud. Para más detalle sobre estas API de Genesys Cloud visitar: https://developer.genesys.cloud/routing/outbound/
Configuración de Pure Cloud Get a Contact
Nombre Descriptor único de caja de configuración con fines de identificar la misma en el flujo.
Subconjunto Credenciales
Región: Campo tipo lista para selección de región donde se encuentra la operación de Genesys. Ejemplo --> us_east_1
ClientID: Campo de tipo GUID en el cual se indica el Client Id de la API de Genesys Cloud para crear token de conexión.
Token: Campo de tipo string alfanumérico en el cual se debe indicar el Token de creación o secreto del cliente para la conexión a Genesys Cloud.
Subconjunto Configuración
ID Lista de contactos: Campo de tipo String, debe contener el ID específico de la lista de contactos que se desea consultar.
En la API este valor estará en la cabecera del Json Response junto con el identificador de nombre de lista.
Ejemplo
ID de lista: 9d40f414-6cab-47fe-9db3-XXXX750667
Estructura de Lista de contactos de Genesys via API
"entities":
{
"id": "9d40f414-6cab-47fe-9db3-XXXX750667",
"name": "demo2",
"dateCreated": "2018-07-07T14:43:14.226Z",
"version": 1,
"division": {
"id": "000000c-1e89-4608-898c-3d80de90db1b",
"name": "Home",
"selfUri": "/api/v2/authorization/divisions/000000-1e89-4608-898c-3d80de90db1b"
},
"columnNames": [
"Id_Contacto",
"cli_nombre",
"cli_apellido_pat",
],
"phoneColumns": [
{
"columnName": "fono12",
"type": "Móvil1"
}
],
"emailColumns": [],
"previewModeColumnName": "",
"previewModeAcceptedValues": [],
"automaticTimeZoneMapping": false,
"selfUri": "/api/v2/outbound/contactlists/9d40f414-6cab-47fe-9db3-123d57750667"
},
{
"id": "cab9a25d-acdf-48c6-a7c4-eb3fc36f0cad",
"name": "DEMO_CLIENTE",
"dateCreated": "2020-04-09T02:59:49.658Z",
"version": 1,
"division": {
"id": "59324a6c-0000-4608-898c-3d8XXXXXdb1b",
"name": "Home",
"selfUri": "/api/v2/authorization/divisions/59324a6c-0000-4608-898c-3d8XXXXXdb1b"
},
"columnNames": [
"Id_Registro",
"Identificacion_Cliente",
"Telefono_1",
],
"phoneColumns": [
{
"columnName": "Telefono_1",
"type": "Móvil"
},
],
"emailColumns": [],
"previewModeColumnName": "",
"previewModeAcceptedValues": [],
"automaticTimeZoneMapping": false,
"selfUri": "/api/v2/outbound/contactlists/0000000-acdf-48c6-XXXXX-eb3fc36f0cad"
},
"pageSize": 84,
"pageNumber": 1,
"total": 2,
"firstUri": "/api/v2/outbound/contactlists?pageSize=84&pageNumber=1",
"lastUri": "/api/v2/outbound/contactlists?pageSize=84&pageNumber=1",
"selfUri": "/api/v2/outbound/contactlists?pageSize=84&pageNumber=1",
"pageCount": 1
}
-- Resultado: nótese que el Json resultado devuelve 2 listas de contactos cuyo "dateCreated" está ordenado
{
"entities": [
{
"id": "a2f0e721-OOOO-4418-8655-03954eXXXXXX",
"name": "Test",
"dateCreated": "2019-07-29T19:41:24.553Z",
"version": 1,
"division": {
"id": "YYY24a6c-XXXX-4608-898c-3d80de900000",
"name": "Home",
"selfUri": "/api/v2/authorization/divisions/YYY24a6c-XXXX-4608-898c-3d80de900000"
},
"columnNames": [
"CELULAR",
"RUT",
],
"phoneColumns": [
{
"columnName": "CELULAR",
"type": "Móvila"
}
],
"emailColumns": [],
"previewModeColumnName": "",
"previewModeAcceptedValues": [],
"automaticTimeZoneMapping": false,
"selfUri": "/api/v2/outbound/contactlists/YYYYe721-0000-4418-8655-03954e2RRRRRR"
},
{
"id": "000000-ccf4-4d49-FFFF-310b028460df",
"name": "NUEVA_LISTA_CONTACTO",
"dateCreated": "2020-01-14T15:45:20.153Z",
"version": 1,
"division": {
"id": "PPPPPP-1e89-4608-YYYY-3d80de90db1b",
"name": "Home",
"selfUri": "/api/v2/authorization/divisions/000000-1e89-4608-898c-3d80de90db1b"
},
"columnNames": [
"Organization",
"Name",
"PAGO"
],
"phoneColumns": [
{
"columnName": "PHONE_NUMBER_Mobile"_1,
"type": "Móvil5"
}
],
"emailColumns": [],
"previewModeColumnName": "",
"previewModeAcceptedValues": [],
"automaticTimeZoneMapping": false,
"selfUri": "/api/v2/outbound/contactlists/000000-ccf4-YYYY-a993-310b028460df"
}
],
"pageSize": 2,
"pageNumber": 1,
"total": 84,
"pageCount": 42
}
ID de contacto: Campo de tipo String, debe contener el ID de contacto que se desea consultar.
Ejemplo
ID contacto e815c5a8-8b7b-48ed-a948-9a9f7be065ea
Estructura de contacto
{
"id": "e815c5a8-8b7b-48ed-a948-9a9f7be065ea",
"firstName": "John",
"lastName": "Doe",
"modifyDate": "2019-07-17T15:12:42Z",
"createDate": "2019-07-17T15:12:42Z",
"schema": {
"id": "dfaefb61-d0a8-4ddb-89e3-016c5f71ce70",
"version": 1,
"selfUri": "/api/v2/externalcontacts/contacts/schemas/dfaefb61-d0a8-4ddb-89e3-016c5f71ce70/versions/1"
},
"customFields": {
"id_identifier": "1234a",
"billingCode_text": "5678b",
"recruitingAgency_text": "Lumber Superstarz",
"certificate_longtext": "Chopping/sawing certification 2020",
"discipline_enum": "legal",
"employmentType_enum": "hourly",
"ranking_integer": 4,
"allocation_number": 75.5,
"startDate_date": "2018-04-03",
"lastContacted_datetime": "2018-04-12T12:07:59.000Z",
"active_checkbox": true,
"skills_tag": [
"sawing",
"chopping"
]
},
"selfUri": "/api/v2/externalcontacts/contacts/e815c5a8-8b7b-48ed-a948-9a9f7be065ea"
}
El nombre de la entidad donde almacenar el resultado obtenido de una expresión o servicio: Campo de tipo de string. Aquí debe ingresar el nombre de la entidad donde se almacenará el resultado obtenido de una expresión o servicio. La entidad debe estar creada previamente.
La intención a ejecutar en caso de error: El flujo de la acción se interrumpirá y la descripción del error se pasará a la intención seleccionada con el nombre: 'PURE_CLOUD_OUTBOUND_ON_ERROR'.
Nota 📑 para conocer más detalles de los códigos API RESPONSE de Gcloud consultar GET /api/v2/outbound/contactlists/{contactListId}/contacts/{contactId}
Ejemplo de implementación de PureCloudGetContactList
-- Entrada
[ID Lista de contactos]: 22222222-bc5f-4603-9c25-ddddddddddddd
[ID de contacto]: e815c5a8-8b7b-48ed-a948-9a9f7be065ea
[El nombre de la entidad donde almacenar el resultado obtenido de una expresión o servicio]: out1 --> vacio
[La intención a ejecutar en caso de error]: error_out1
-- Resultado
entidad --> out1:
{
"id": "",
"name": "",
"contactListId": "",
"data": {
"": ""
},
"callRecords": {
"": {
"lastAttempt": "",
"lastResult": ""
}
},
"latestSmsEvaluations": {
"": {
"contactColumn": "",
"contactAddress": "",
"messageType": "",
"wrapupCodeId": "",
"timestamp": ""
}
},
"latestEmailEvaluations": {},
"callable": true,
"phoneNumberStatus": {
"": {
"callable": true
}
},
"contactableStatus": {
"": {
"contactable": true,
"columnStatus": {
"": {
"contactable": true
}
}
}
},
"contactColumnTimeZones": {
"": {
"timeZone": "",
"columnType": ""
}
},
"configurationOverrides": {
"priority": true
},
"dateCreated": "",
"selfUri": ""
}