Requisitos
- Acceso de administrador al agente IA en Agentes IA – Avanzado
- Suscripción a Zendesk
- Espacio de trabajo de agente de Zendesk
- Una licencia de Sunshine Conversations
Paso 1: Crear una clave de API
En el Centro de administración de Zendesk, vaya a Aplicaciones e integraciones > API > API de conversaciones.
Si no ve esto, comuníquese con Zendesk para agregarlo a su configuración, o puede tener acceso al panel de Smooch, en cuyo caso siga estas instrucciones.
- Cree una clave de API nueva para el agente IA.
- Asigne un nombre a la clave de API.
- Se mostrará una página con el ID de la aplicación, el ID de la clave y el secreto; cópielos y guárdelos.
Paso 2: Configurar los parámetros de integración de grupos en Agentes IA – Avanzado
Debe agregar Sunshine Conversations como integración de CRM antes de configurar los parámetros de integración para su autorización.
Nota: agregamos el enrutamiento de Sunshine Group. Es una nueva función que permite el enrutamiento a diferentes agentes IA en nuestro panel para atender las consultas de los clientes en distintos canales.
Por lo tanto, recomendamos usar esto para todos nuestros clientes que usan Mensajería de Zendesk y Sunshine Conversations, incluso si solo tienen un agente IA en este momento.
Para agregar Sunshine Conversations como integración de CRM:- Vaya a Configuración > Integración de CRM.
- Haga clic en Agregar integración de CRM.
- Seleccione Grupo de Sunshine > Crear grupo.
- En el campo Grupo de transferencia, ingrese el ID del grupo de agentes en Zendesk. Haga clic aquí para averiguar cómo ubicar el ID del grupo.
- La URL de avatar es una imagen que se puede usar como imagen de perfil para su avatar en el área de chat. La API de Sunshine Conversations detrás de la función es el extremo postMessage. Como se indica en la documentación, avatarUrl debe estar en formato JPG, PNG o GIF.Nota: actualmente, esto solo es visible en Sunshine Conversations y no se muestra en Zendesk.
Para configurar los parámetros de integración de grupos:
- Vaya a Configuración > Integración de CRM.
- Haga clic en Parámetros de integración de grupos. Se abrirá una nueva página.
- Obtenga la información de esta página desde la aplicación creada en el Paso 1 en Sunshine Conversations. Esta información es necesaria para autorizar la conexión entre Agentes IA – Avanzado y Sunshine.
Para obtener los parámetros de integración de grupos de Sunshine Conversations:
-
Haga clic en la aplicación creada en el Paso 1 y vaya a Configuración.
-
Copie los siguientes parámetros de la aplicación para ingresarlos en Agentes IA – Avanzado:
- App ID
-
ID de clave
-
Clave secreta
-
Nota: haga clic en Crear nueva clave de API si no ve ninguna.
-
- Haga clic en Guardar.
Paso 3: Autorizar la conexión entre Agentes IA – Avanzado y Sunshine
Este paso solo es necesario si usa Sunshine Conversations con Zendesk. Si usa plataformas distintas de Zendesk, omita este paso y contáctenos.
- No modifique el panel de Agentes IA – Avanzado.
- Abra Sunshine Conversations e inicie sesión en otra pestaña.
-
En el panel de Agentes IA – Avanzado, en Autorización, haga clic en Autorizar a Sunshine Conversations.
-
Se abrirá una nueva página
-
Si se le solicita, ingrese su subdominio de Zendesk e inicie sesión con su cuenta de Zendesk.
-
Si se autoriza mediante el panel de Smooch, seleccione la aplicación creada en el Paso 1.
-
-
Esto se completa cuando el botón en en panel de Agentes IA – Avanzado cambie a Desautorizar a Sunshine Conversations.
-
Esto solo debe hacerse una vez si tiene más de un agente IA.
Paso 4: Probar su agente IA
Abra el widget de Sunshine, hable con el agente IA y verifique que todo funcione.
¿No sabe dónde está el widget? Esta es la documentación de Sunshine sobre cómo agregarlo a su página web. Le recomendamos que hable con el desarrollador o el administrador de su sitio web y comparta el documento con ellos.
Si tiene otros canales, como WhatsApp, Facebook Messenger o Instagram, consulte la documentación de Sunshine Conversations sobre cómo realizar la integración con distintos canales. Una vez allí, puede consultar detalles de cada canal en el menú lateral.
Nota: si desea personalizar la imagen de avatar del agente de IA, proporcione una imagen que cumpla los siguientes requisitos a su CSM; podemos configurarlo por usted más adelante.
- png, jpg o gif
- tamaño mínimo de 128x128
- las mismas dimensiones de altura y ancho (o Sunshine Conversations la ampliará para ajustarla)
PREGUNTAS FRECUENTES
Cómo editar los parámetros de integración después de la configuración
Es posible que observe que cuando intenta editar una integración activada no es posible guardar los cambios. Esta es una función de seguridad para garantizar que las integraciones en vivo no se modifiquen por accidente.
Sin embargo, es posible hacer cambios, pero primero tiene que desactivar la opción de automatización.
Una vez desactivado, se podrá hacer clic en el botón no autorizado de Sunshine Conversations y luego se podrá desactivar. Desde aquí se pueden hacer ediciones y repetir el proceso descrito anteriormente.
Conexión mediante el panel de Smooch
Paso 1: Crear una aplicación nueva en Sunshine Conversations
Inicie sesión en Sunshine Conversations en https://app.smooch.io/login y cree una aplicación nueva.
- Si ya tiene una aplicación de Sunshine Conversations conectada a su cuenta de Zendesk, continúe al Paso 4.
- Si usa Zendesk, pero aún no tiene una aplicación de Sunshine Conversations, continúe con el Paso 2.
- Si usa plataformas distintas de Zendesk, omita el paso 4 o contáctenos.
Paso 2: Conectar la aplicación de Sunshine a su instancia de Zendesk
Este paso es crucial para que funcione Agentes IA – Avanzado y solo se puede hacer en Sunshine Conversations o Zendesk.
Pídale al administrador de su cuenta de Sunshine Conversations o Zendesk que agregue su cuenta de Zendesk a la aplicación creada en el Paso 1 en Sunshine Conversations. Verá que Zendesk aparece como una integración conectada cuando haga clic en la aplicación en Sunshine Conversations.
Después de estos pasos, continúe desde el paso 3 como se mencionó anteriormente.