Estas son respuestas a preguntas frecuentes relacionadas con:

Puedes crear un nuevo espacio de trabajo para desarrolladores para desarrollar apps. Los espacios de trabajo para desarrolladores son gratuitos y están destinados solo para fines de desarrollo. Una vez creado el nuevo espacio, puedes seguir esta guía para crear una app y hacer tu primera llamada API.

Puedes crear una nueva app para tu espacio de trabajo de producción y obtener el token de acceso para la app yendo a https://app.intercom.com/a/apps/{your-workspace-id}/developer-hub/

Cuando activas tu Articles Help Center, tu contenido está disponible por defecto a través de intercom.help. Tu URL se verá así: intercom.help/exampleapp.

Si deseas usar una URL diferente, puedes crear una configurando manualmente un dominio personalizado. Esto implica ingresar el dominio personalizado en la configuración de tu Help Center, crear un registro CNAME personalizado y opcionalmente configurar SSL. Encuentra las instrucciones completas en nuestra documentación para desarrolladores.

SSL (o TLS) es la forma más utilizada para asegurar la conexión entre tu servidor y tu navegador. Garantiza que la conexión entre el servidor y el navegador esté cifrada y sea segura, y aparece como HTTPS.

Hay dos formas de configurar SSL con Articles en tu dominio personalizado:

¡Sí! Si activas “HTTPS (quick setup)” en la configuración de tu Help Center, Intercom proporcionará y gestionará automáticamente un certificado SSL para tu dominio personalizado (como https://help.ourdomain.com). No es necesario configurar SSL manualmente: solo apunta tu CNAME a us.intercomhelpcenter.com, y nosotros nos encargamos del resto.

Si deseas cambiar tu dominio personalizado a HTTPS:

Puedes configurar SSL para tu dominio personalizado para mantener la información sensible cifrada. Si deseas hacerlo, asegúrate de haber configurado tu CNAME con un proveedor DNS que soporte SSL, como Cloudflare.

Sigue la guía en nuestra documentación para desarrolladores para configurar SSL. Ten en cuenta que, dependiendo del proveedor que elijas, los pasos pueden variar.

1. Dominio no seguro

La versión actual de la API es 2.15. Puedes encontrar la documentación de la API en nuestro sitio de documentación para desarrolladores. También puedes cambiar la versión que usa tu app en tu Developer Hub siguiendo los pasos indicados en esta guía.

Si usas la API de Intercom, también puedes cambiar la versión dentro del encabezado HTTP de tu solicitud.

Los siguientes endpoints están disponibles en la versión 2.15 de la API de Intercom:

Sí, si quieres abrir un artículo en el Messenger, puedes usar el método showArticle del API de JavaScript. El artículo se abrirá dentro del Messenger y al hacer clic en el botón de retroceso del Messenger volverás al contexto anterior. Si el Messenger está cerrado cuando se llama al método, primero se abrirá y luego se mostrará el artículo. Esto está disponible en todas las plataformas del Messenger.

En Intercom, los users están bajo la etiqueta de contacts. No hay un endpoint para crear contacts en masa usando la API, pero puedes usar el endpoint de crear contacts para crear un script que importe users o seguir este tutorial que te dará ejemplos de código para empezar.

Asegúrate de configurar una verificación de limitación de tasa para asegurarte de no superar el límite, que actualmente es de 10,000 llamadas API por minuto para cada app y 25,000 llamadas API por minuto por workspace.

Para recuperar los datos de un contact archivado primero debes desarchivar el contact, lo cual puedes hacer con el endpoint de desarchivar contact de la API si tienes el ID del contact.

Luego podrás acceder nuevamente a los datos del contact a través del endpoint de obtener un contact de la API y a sus conversaciones a través del endpoint de recuperar una conversación de la API.

No, actualmente no hay forma de eliminar notas individuales o eliminar notas en masa de contacts vía la API. Si esta funcionalidad es importante para tus operaciones, por favor visita el Product Wishlist para crear, comentar o votar una solicitud de función. Las notas pueden eliminarse manualmente dentro del workspace, pero solo una a la vez.

Si desea asignar una conversación a un equipo usando la API, tiene dos opciones.

La primera opción es asignar una conversación directamente a un administrador o a un equipo usando el endpoint de API para gestionar una conversación. Necesita tener acceso al id provisionado de Intercom para la conversación, así como al admin_id y al assignee_id.

La otra opción es ejecutar reglas de asignación que ya haya configurado en la conversación usando el endpoint de API para ejecutar reglas de asignación en una conversación. Necesita tener acceso al id provisionado de Intercom para la conversación.

Puede probar la funcionalidad desde la función "Try It" en nuestra documentación para desarrolladores, la colección Intercom Postman, o en su propio terminal o IDE. No olvide usar su token de acceso de Intercom como token bearer.

Una nota es un comentario interno visible solo para los compañeros de equipo. Para agregar una nota a una conversación puede usar el endpoint de API para responder a una conversación. Deberá elegir un messsage_type de nota y un tipo "admin" junto con el admin_id desde el cual debe provenir la nota.

Puede probar la funcionalidad desde la función "Try It" en nuestra documentación para desarrolladores, la colección Intercom Postman, o en su propio terminal o IDE. No olvide usar su token de acceso de Intercom como token bearer.

Si ya ha creado una etiqueta en la interfaz de usuario, puede usar esa etiqueta para aplicarla a las conversaciones. También puede crear una nueva etiqueta usando la API.

Para usar el endpoint de API para agregar una etiqueta a una conversación, necesitará tener acceso al conversation_id de la conversación a etiquetar, al id provisionado de Intercom de la etiqueta y al admin_id.

Puede probar la funcionalidad desde la función "Try It" en nuestra documentación para desarrolladores, la colección Intercom Postman, o en su propio terminal o IDE. No olvide usar su token de acceso de Intercom como token bearer.

Puede crear una conversación desde la API que haya sido iniciada por un contacto (es decir, user o lead) usando el endpoint de API para crear una conversación. La conversación puede ser solo un mensaje dentro de la aplicación.

También necesitará el id provisionado de Intercom para el contacto y el texto del cuerpo. Úselo para iniciar la conversación.

Puede probar la funcionalidad desde la función "Try It" en nuestra documentación para desarrolladores, la colección Intercom Postman, o en su propio terminal o IDE. No olvide usar su token de acceso de Intercom como token bearer.

Para cerrar una conversación usando la API puede usar el endpoint de API para gestionar una conversación. Necesitará tener el id provisionado de Intercom de la conversación, su admin_id y usar un message_type de "close".

Si necesita redactar solo una parte de la conversación, use el endpoint de API para redactar una parte de la conversación.

Puede probar la funcionalidad desde la función "Try It" en nuestra documentación para desarrolladores, la colección Intercom Postman, o en su propio terminal o IDE. No olvide usar su token de acceso de Intercom como token bearer.

Para configurar una notificación personalizada cuando se realice una acción, como que un compañero de equipo sea asignado a una conversación, puede usar webhooks.

Querrá usar el tema conversation.admin.assigned. Puede encontrar todos los temas de conversación en nuestra documentación para desarrolladores.

Luego puede suscribirse a este tema de webhook en el centro de desarrolladores siguiendo los pasos en esta guía aquí. También necesitará tener una URL de endpoint accesible públicamente para que la acción se realice una vez que se active el webhook y entregue la notificación a su canal preferido.

Las conversaciones laterales no tienen un endpoint dedicado propio, por lo que no puede recuperarlas directamente. Sin embargo, cuando recupera una conversación a la que está adjunta la conversación lateral, verá partes de la conversación que aparecen como "part_type": "side_conversation_reply" con el contenido de los mensajes del user en la conversación lateral.

Para crear un ticket usando la API de Intercom, primero deberá crear u obtener el tipo de ticket para etiquetar el nuevo ticket. Luego puede crear el ticket usando una solicitud curl o con un lenguaje de programación de su elección.

Siga esta guía de nuestra documentación para desarrolladores para crear un tipo de ticket y crear un nuevo ticket.

Si está usando la API para recuperar tickets y datos de tickets, puede usar el endpoint de API para buscar tickets. Para excluir tipos de tickets de back office, establezca el campo en ticket_type_id y use el operador != para excluir el ticket_type_id asignado a los tipos de tickets de back office.

Si está usando la API para recuperar una conversación o listar conversaciones con tickets de back office asociados a las conversaciones y desea excluirlos, puede filtrar de manera similar cualquier resultado que tenga el tipo de ticket de back office como atributo. Los tickets vinculados se pueden encontrar en el parámetro tickets en la respuesta o bajo linked_objects.

Otra opción disponible es usar la API para etiquetar conversaciones con un ticket de back office asociado. Luego puede usar la etiqueta para filtrar por categoría de ticket.

Si recibe un mensaje 403 API Plan restricted en una respuesta, esto significa que la API que está intentando usar no está disponible en el plan de su aplicación.

Para acceder a la API necesitará actualizar su plan. Puede obtener más información sobre los planes de Intercom en esta página. Puede encontrar una lista completa de códigos de error y respuestas HTTP en nuestra documentación para desarrolladores.

Si recibe un mensaje 409 conflict en una respuesta, esto significa que hay datos existentes en su espacio de trabajo de Intercom que entran en conflicto con los datos de la solicitud. Esto puede ocurrir si intenta crear un contacto y ya hay un contacto con esa dirección de correo electrónico agregado en su aplicación.

Para evitar este error puede usar el endpoint de actualización o crear un nuevo contacto por user_id. Puede encontrar una lista completa de códigos de error y respuestas HTTP en nuestra documentación para desarrolladores.

Si recibe un mensaje 429 significa que el cliente ha alcanzado o superado un límite de tasa, o que el servidor está sobrecargado. Cada aplicación tiene un límite de tasa predeterminado de 10,000 llamadas API por minuto para cada aplicación y 25,000 llamadas API por minuto por espacio de trabajo. Más información sobre límites de tasa está disponible en nuestra documentación para desarrolladores.

Para evitar este error puede configurar una verificación de límite de tasa para asegurarse de no alcanzar el límite. Puede encontrar una lista completa de códigos de error y respuestas HTTP en nuestra documentación para desarrolladores.

Las aplicaciones privadas tienen un límite de tasa predeterminado de 10,000 llamadas API por minuto por aplicación y 25,000 llamadas API por minuto por espacio de trabajo. Esto significa que si un espacio de trabajo tiene varias aplicaciones privadas instaladas, cada una contribuye al número total de solicitudes.

Las aplicaciones públicas tienen un límite de tasa predeterminado de 10,000 llamadas API por minuto para cada aplicación y 25,000 llamadas API por minuto por espacio de trabajo. Esto significa que si un espacio de trabajo tiene varias aplicaciones públicas instaladas, cada una tiene su propio límite de solicitudes separado sin contribuir a las demás. Más información sobre límites de tasa está disponible en nuestra documentación para desarrolladores.

Si está creando sus propios informes usando la API, puede notar que hay algunas diferencias entre los dos informes. Esto puede suceder por varias razones.

Un problema común es cuando las fechas y horas no coinciden. Esto suele deberse a que la zona horaria que está usando en su espacio de trabajo de Intercom es diferente a la zona horaria que usa para consultar la API. Para solucionarlo, ajuste los parámetros de consulta de la API para que coincidan con la zona horaria de su espacio de trabajo o cambie la zona horaria de su informe personalizado.

Otro problema es que puede que estés usando métricas que no se alinean con las métricas de la interfaz de usuario de informes de Intercom. Hay algunas métricas disponibles en la interfaz de usuario de informes que no están disponibles vía API porque son métricas calculadas. Algunas de ellas pueden crearse usando la API y realizando los cálculos en tu lado. Consulta la guía para crear tus propios informes en la documentación para desarrolladores de Intercom.

Si estás viendo los informes de conversaciones disponibles en la interfaz de usuario frente a los informes extraídos usando la API de conversaciones, puede que notes una diferencia en el número de conversaciones. Esto se debe a que los back office tickets asociados con una conversación se incluirán cuando se extraigan desde la API.

Para resolver esto, puedes filtrar los resultados después de recuperarlos vía la list conversations, retrieve a conversation o search for conversations API, y separar los tickets de las conversaciones usando el campo ticket en la respuesta de la API de conversación. El campo ticket se llenará con un objeto si es un ticket y será nulo si es una conversación.

Los webhooks te permiten suscribirte a notificaciones en tiempo real de eventos que ocurren en Intercom, como cuando se crea un contacto o se recibe un mensaje entrante.

Puedes ver los webhooks disponibles para cada versión en nuestra documentación para desarrolladores. Una vez que hayas identificado qué webhook necesitas, sigue esta guía para configurarlos.

No hay planes para agregar nuevos webhooks en nuestra hoja de ruta, pero si hay un webhook que tu equipo necesita, por favor envía una solicitud al equipo o agrégalo a la lista de deseos del producto en la comunidad de Intercom.

Las APIs de Intercom para listar y buscar recursos ofrecen paginación basada en cursor. Esto está disponible para que cuando solicites una gran cantidad de datos — como muchas conversaciones con todas sus partes — puedas recibirlos y procesarlos en fragmentos más pequeños.

Para ejemplos sobre cómo usar la paginación tanto con las APIs de lista de Intercom, que aceptan parámetros de ruta, como con las APIs de búsqueda, que usan parámetros de consulta, consulta nuestra guía de paginación.

Para la paginación basada en cursor, Intercom usa un puntero que se refiere a un registro específico basado en el límite que establezcas por el número de páginas que especifiques por solicitud.

Cuando se devuelve en un objeto, el puntero se verá algo así como 'WzXXXXXXXXXXXXXX'.

Luego puedes usar el puntero de la respuesta para hacer la solicitud siguiente para el próximo lote de datos.

El formato de paginación en la solicitud difiere ligeramente entre las APIs de lista y las APIs de búsqueda, pero las respuestas funcionan igual.

Puedes ver ejemplos de solicitudes curl en nuestra página de Paginación, y tutoriales sobre cómo usar las APIs de lista y las APIs de búsqueda.

Cualquier aplicación que interactúe con datos de espacios de trabajo de terceros y aplicaciones construidas con Canvas Kit requieren que OAuth esté implementado. Nunca debes pedir a los users su token de acceso y solo usar OAuth para interactuar con sus datos.

Consulta la documentación para instrucciones para configurar OAuth.

Necesitarás configurar OAuth si estás construyendo una integración con Intercom que accede a los datos de otras personas en Intercom. Esto incluye aplicaciones públicas que planeas listar en la tienda de aplicaciones de Intercom, así como aplicaciones e integraciones que pedirás a los users que instalen a través de tu propio sitio web. Aprende más sobre OAuth en nuestra documentación para desarrolladores.

Si solo accedes a datos dentro de tu propio espacio de trabajo de Intercom, puedes usar un token de acceso.

Si estás construyendo una aplicación privada que solo accede a datos en tu espacio de trabajo de Intercom, puedes usar tu token de acceso de Intercom para la autenticación. Encuentra tu token de acceso en tu centro de desarrolladores y aprende más sobre autenticación aquí.

Puedes usar tu token de acceso de Intercom si estás usando la API para acceder a datos en tu propio espacio de trabajo de Intercom. Encuentra tu token de acceso en tu centro de desarrolladores y aprende más sobre autenticación aquí.

Para encontrar tu token de acceso de API, sigue estos pasos:

Puedes construir una aplicación para tu Intercom Inbox usando Canvas Kit, un conjunto de herramientas que te permite crear aplicaciones que funcionan directamente dentro de la interfaz de usuario de Intercom.

Sigue este tutorial para aprender cómo construir tu primera aplicación para Inbox. También puedes aprender más sobre Canvas Kit y encontrar documentación de referencia en nuestra documentación para desarrolladores.

Puedes construir una aplicación para tu Intercom Messenger usando Canvas Kit, un conjunto de herramientas que te permite crear aplicaciones que funcionan directamente dentro de la interfaz de usuario de Intercom.

Ten en cuenta que las personalizaciones están limitadas a lo que es posible a través de Canvas Kit y deben crearse dentro del Messenger: no es posible recrear o cambiar la apariencia del Messenger.

Sigue este tutorial para aprender cómo construir tu primera aplicación para Inbox. También puedes aprender más sobre Canvas Kit y encontrar documentación de referencia en nuestra documentación para desarrolladores.

Si visitas la página Test & Publish > Your Workspaces de tu aplicación en el Developer Hub, deberías ver todos los espacios de trabajo de los que eres miembro como integrante del equipo de Intercom.

Puedes hacer clic en Instalar aplicación junto al espacio de trabajo donde quieres instalar la aplicación dada. Esta aplicación se instalará y se proporcionará un Access Token para ese espacio de trabajo para que puedas acceder a sus datos a través de la API.

Para instrucciones de instalación de terceros, consulta nuestra documentación para desarrolladores.

Cuando estés listo para publicar tu app, puedes seguir los pasos en el developer hub. Puedes encontrar una guía sobre cómo publicar tu app en nuestra documentación para desarrolladores.

El SDK de Intercom para iOS te permite usar el Intercom Messenger en tu app, tener conversaciones con tus clientes, enviar mensajes salientes enriquecidos, mostrar tu Help Center y rastrear eventos.

Puedes instalar Intercom para iOS usando Cocoapods, Swift Package Manager o manualmente. Lee los detalles aquí. Puedes encontrar Intercom para iOS en GitHub junto con una app de ejemplo que puedes usar para probar el SDK aquí.

El SDK de Intercom para Android te permite usar el Intercom Messenger en tu app, tener conversaciones con tus clientes, enviar mensajes salientes enriquecidos, mostrar tu Help Center y rastrear eventos.

Puedes instalar Intercom para Android usando Gradle o manualmente. Lee los detalles aquí. Puedes encontrar Intercom para Android en GitHub junto con una app de ejemplo que puedes usar para probar el SDK aquí.

El wrapper de Intercom React Native te permite usar Intercom para iOS y Intercom para Android en tus apps React Native. Sigue los pasos de configuración aquí.