Integración de Intercomunicador con App Builder

Integración de Intercom con App Builder aplicaciones

Esta guía cubrirá los sencillos pasos necesarios para agregar Intercom, una aplicación de mensajería de terceros, a cualquier App Builder aplicación. El resultado final es que tu App Builder la aplicación se conectará a Intercom y podrás chatear directamente con los usuarios a través de la aplicación. Puedes responder a los mensajes de los usuarios cuando hayas iniciado sesión en el sitio web de Intercom, enviar respuestas correo a su ventana de chat o incluso responder a través de Slack. El tiempo total de configuración es de aproximadamente 10 minutos.

Para obtener documentación o ayuda adicional sobre Intercom, consulte el Centro para desarrolladores de Intercom, Centro de ayuda de Intercom, o Foro de la comunidad.

adjunto

Cómo Configurar App Builder integración de Aplicaciones

Inicie sesión en el sitio web de Intercom con las credenciales de su cuenta de Intercom
Haga clic en el ícono de perfil en la parte inferior izquierda -> Jitterbit (o el nombre de su cuenta) -> Agregar un nuevo espacio de trabajo…
Nota
1. Debes crear una versión 'Prod' (para el ambiente de producción) y una versión 'Test' (para los ambientes Dev y QA).
2. Debe completar la configuración del espacio de trabajo, incluida la adición de una tarjeta de crédito, para que la integración funcione y el ícono del intercomunicador se muestre correctamente en App Builder.
Asegúrate de que tu aplicación esté "marcada".
Tome nota del AppID en la URL del espacio de trabajo (el AppID también se puede encontrar en el bloque de código Javascript del widget prefabricado).
En App Builder, cree una nueva Plantilla HTML para Intercom, conectada a una Colección a la que la aplicación tenga acceso, y cree entradas para los siguientes tres Parámetros:
- ID de aplicación
- Correo
- Nombre de usuario

Pegue el siguiente código en el área Contenido (texto) de la modelo:

<script>
window.intercomSettings = {
  name: "<UserName>", // Full name WHO()
  email: "<Email>", // WHO('Email')
  app_id: "<AppID>" // Provided by Intercom
};
</script>

<script>
(
  function(){
    var w=window;
    var ic=w.Intercom;

    if(typeof ic==="function"){
      ic('reattach_activator');
      ic('update',intercomSettings);
    }
    else{
      var d=document;
      var i=function(){i.c(arguments)};
      i.q=[];
      i.c=function(args){i.q.push(args)};
      w.Intercom=i;

      function l(){
        var s=d.createElement('script');
        s.type='text/javascript';
        s.async=true;
        s.src='https://widget.intercom.io/widget/<AppID>';
        x=d.getElementsByTagName('script')[0];
        x.parentNode.insertBefore(s,x);
      }

      l();

      if(w.attachEvent){
        w.attachEvent('onload',l);
      }
      else{
        w.addEventListener('load',l,false);
      }
    }
  }
)
() //Manually Call the Listener if the page is loaded
</script>

Agrega un campo a tu tabla Parámetros para almacenar el ID de la aplicación Intercom. Toma el valor de cadena creado en Intercom y pégalo en esta ubicación.
Agregue los campos Param IntercomAppID, WHO() y WHO(' Correo') al objeto de datos subyacente utilizado en la página de inicio o de bienvenida de la aplicación, y a cualquier otro punto de "entrada" de la aplicación.

Si el usuario ingresa a través de una página que tiene esta modelo de Intercom, en cada página posterior se mostrará el ícono de 'Chat' en la parte inferior derecha. Sin embargo, si ingresa a la aplicación a través de una página que NO tiene la modelo HTML, no verá el ícono ni tendrá la funcionalidad de Intercom.

Importante

El Correo del usuario es un campo obligatorio: LA INTEGRACIÓN DEL INTERCOMUNICADOR NO FUNCIONARÁ SI EL USUARIO NO TIENE UN CORREO ELECTRÓNICO EN LA CONFIGURACIÓN DE SU PERFIL
Agrega un Control HTML a la página donde estás configurando la integración de Intercom (normalmente la página de inicio o la página de presentación). Conecta la Información de plantilla > Plantilla a la plantilla HTML creada.
Haga clic en el ícono Enlace para la plantilla HTML (desde el detalle de Control) y cree entradas de asignación:

Parámetro de plantilla Nombre de control o columna

ID de aplicación ID de aplicación de intercomunicador

Correo Correo electrónico del usuario

Nombre de usuario Nombre de usuario
Actualice su página y ahora debería ver el ícono del intercomunicador.

Integración de Slack

Puedes configurar Intercom de forma inmediata para enviar notificaciones a un canal de Slack.

adjunto

Desde la cuenta del sitio web de Intercom, haz clic en el ícono de foto de perfil en la parte inferior izquierda. Asegúrate de que tu aplicación esté marcada y luego haz clic en Integraciones.
Desplácese hacia abajo y localice la opción Slack y haga clic en Integrar
Elige qué notificaciones quieres reenviar al canal de Slack y luego haz clic en el botón Conectar a Slack.
Inicie sesión en el canal de Slack del equipo. Elija a qué canal desea que lleguen las notificaciones. Para realizar pruebas, debe seleccionar la opción Slackbot y las notificaciones solo se mostrarán a usted.
Ahora debería recibir una notificación de que se ha agregado Intercom y todos los mensajes nuevos aparecerán en el canal seleccionado.
Para responder, debes hacer clic en el enlace "Un mensaje" en la aplicación, que te llevará al sitio web de Intercom. Actualmente, necesitarías un software adicional que te permita responder directamente desde Slack.

Consejos y Solución de Problemas

La guía general es iniciar sesión en la cuenta del sitio web de Intercom y probar la funcionalidad de mensajería entre esta y la aplicación. El panel de control y el sitio web de Intercom ofrecen muchas estadísticas y datos relevantes, como quién ha iniciado sesión activamente en la aplicación, el historial de mensajes, etc.
Tenga en cuenta que el botón Intercom parece funcionar bien en general en Chrome tanto en Windows como en Mac. Safari en Mac parece ser muy inconsistente. Asegúrese de probar su despliegue utilizando varios navegadores y, idealmente, también diferentes sistemas operativos.
Como ocurre con todos App Builder aplicaciones que recomendamos crear una versión 'Prod' (para el ambiente de producción) y una versión 'Test' (para ambientes Dev y QA)

Parámetro de plantilla	Nombre de control o columna
ID de aplicación	ID de aplicación de intercomunicador
Correo	Correo electrónico del usuario
Nombre de usuario	Nombre de usuario