Trabajar con la mensajería en los SDK para Android y iOS

Después de activar la mensajería, es posible agregarla a una aplicación para Android o iOS.

Este artículo contiene los siguientes temas:

• Acerca de la mensajería para Android y iOS
• Crear un nuevo canal de Android o iOS para la mensajería
• Personalizar y configurar el SDK de Zendesk para Android y iOS
• Obtener la clave del canal para la instalación

Acerca de la mensajería para Android y iOS

En las aplicaciones móviles de Zendesk, la funcionalidad de mensajería se proporciona a través de los nuevos SDK para Android y iOS. Verifique que la mensajería esté activada antes de comenzar el proceso de creación. Después de activar la mensajería, puede personalizar y configurar el aspecto de un SDK y otras opciones a través del Centro de administración, y luego proporcionar al desarrollador una clave del canal que necesitará para completar la integración de acuerdo a la documentación oficial para desarrolladores.

Crear un nuevo canal de Android o iOS para la mensajería

Si desea configurar los SDK para Android o iOS, tendrá que crear un canal de Android o iOS en el Centro de administración de Zendesk y asignarlo a una marca antes de poder personalizarlo y configurarlo, como se describe más abajo.

Para crear un nuevo canal para Android/iOS

1. En el Centro de administración, haga clic en el icono Canales () en la barra lateral y luego seleccione Mensajería y redes sociales > Mensajería.
2. Haga clic en el botón Agregar canal y luego seleccione Android o iOS.
3. En la página para agregar Android o iOS, configure cada una de las secciones siguientes:
   • Configurar los aspectos básicos: ingrese el nombre de un canal y luego use el menú desplegable para seleccionar una marca.
   • Aplicar estilos al aspecto: haga clic en los colores para Principal, Mensaje y Acción y luego ingrese un número hexadecimal o utilice el selector para seleccionar los colores.
   • Instalar en la aplicación: se le proporcionará la clave del canal que usted o su equipo de desarrollo podrá usar para instalar el SDK para Android o iOS en su aplicación, y un vínculo a instrucciones detalladas que podrá usar para completar la instalación.
4. Haga clic en Terminar. Se abre la página para editar el SDK para Android o iOS, donde puede continuar configurando el SDK, o dejarlo tal cual.

Si desactiva la mensajería para una marca, el Web Widget se convierte en el Web Widget (clásico).

Personalizar y configurar los SDK de Zendesk para Android y iOS

El SDK de Zendesk incluye varios componentes que se pueden personalizar para que representen mejor a su negocio.

Para configurar la mensajería para Android o iOS

1. En el Centro de administración, haga clic en el icono Canales () en la barra lateral y luego seleccione Mensajería y redes sociales > Mensajería.
2. Pase el cursor por encima de la marca que desea actualizar, haga clic en el icono de opciones () y luego en Editar.
3. Haga clic en la pestaña que tiene los componentes que desea personalizar. Siga los vínculos a continuación si desea información más detallada sobre las opciones para esa pestaña:
   • Información básica (nombre del canal y flujo)
   • Estilo (aspecto del SDK)
   • Notificaciones (configuración de notificaciones push)
   • Instalación (clave del canal e incrustación en el centro de ayuda)

La pestaña Información básica

La pestaña Información básica incluye un campo editable Nombre de canal, y un vínculo a la página de configuración del Generador de flujos del SDK.

El campo Nombre de canal se llena automáticamente con el nombre de la marca. Para que sea más fácil de encontrar en la lista de canales, podría cambiarlo a algo más único.

Para actualizar el nombre del canal

1. En el campo Nombre de canal, borre el texto que desea cambiar.
2. Ingrese el nuevo nombre para el SDK y luego haga clic en el botón Guardar.

La pestaña Estilo

La pestaña Estilo incluye los componentes relacionados con el aspecto del SDK para Android o iOS.

En la sección Cuadro, se puede actualizar lo siguiente:

• Color principal, el color principal del botón del iniciador y el encabezado del SDK. Ingrese un número hexadecimal o haga clic en el muestrario para abrir un selector de color.
• Color del mensaje, el color de la burbuja alrededor de los mensajes de los clientes. Ingrese un número hexadecimal o haga clic en el muestrario para abrir un selector de color.
• Color de la acción, el color de los botones o los elementos en los que se puede hacer clic en la conversación, como los mensajes de respuesta rápida. Ingrese un número hexadecimal o haga clic en el muestrario para abrir un selector de color.
• Logotipo (opcional), un JPG o PNG que debe aparecer en la parte superior del cuadro del SDK. Haga clic en Cargar imagen y luego busque la imagen que desea agregar.
• Título, el texto que aparece en la parte superior de la pantalla de conversación del SDK, normalmente el nombre del negocio o la marca.
• Descripción (opcional), un fragmento pequeño de texto debajo del título. Puede ser información que se desea compartir, o un eslogan, por ejemplo. Ingrese la descripción en el cuadro de texto.

La pestaña Notificaciones

La pestaña Notificaciones es donde se configuran las notificaciones push para el SDK de Zendesk para Android o iOS.

Para Android, proporcione la “Clave” y la “ID del remitente” de Firebase Cloud Messaging:

Para iOS, cargue el archivo .p12 de APNs. También se le solicitará la contraseña del certificado:

Para generar el archivo .p12, debe iniciar sesión en su cuenta de Apple Developer. Si aún no tiene una cuenta de desarrollador, puede inscribirse aquí.

1. Inicie sesión en el Apple Developer Member Center, y vaya a la lista de certificados.
2. Haga clic en el botón + en la parte superior de la página para crear un nuevo certificado y seleccione Apple Push Notification service SSL (Sandbox & Production).
3. Seleccione su ID de la aplicación en la lista desplegable y haga clic para continuar.
4. Siga las instrucciones para generar una solicitud de firma de certificado (Certificate Signing Request, CSR) usando el Acceso a Llaveros, y cárguela para generar el certificado.
5. Una vez que el certificado esté listo, descárguelo al equipo y haga doble clic para abrirlo en Acceso a Llaveros.
6. Haga clic con el botón derecho en el certificado que se creó y seleccione Export “Apple Push Services: {su-id-de-aplicación}”.
7. Elija una contraseña, si lo desea, y guarde el archivo .p12 en el equipo.

Para activar completamente las notificaciones push, los desarrolladores también tienen que completar una serie de instrucciones. Esta instrucciones se encuentran en nuestra documentación oficial para desarrolladores de Android y iOS.

Obtener la clave del canal para la instalación

Para instalar la mensajería en su aplicación móvil, tendrá que proporcionarle una clave del canal a los desarrolladores. La clave del canal, junto con un vínculo a la documentación para desarrolladores oficial de Zendesk, se encuentra en la pestaña Instalación.

Para obtener la clave del canal

1. En el Centro de administración, haga clic en el icono Canales () en la barra lateral y luego seleccione Mensajería y redes sociales > Mensajería.
2. Pase el cursor por encima de la marca que desea actualizar, haga clic en el icono de opciones () y luego en Editar.
3. Haga clic en la pestaña Instalación.
4. Bajo Clave del canal, haga clic en el botón Copiar para copiar la clave al portapapeles y enviarles la información a los desarrolladores.