Integración CRM HubSpot

Introducción

3CX ofrece la integración con HubSpot a través de la API 3CX para CRM con las siguientes características:

• ID de Llamada a Nombre de Contacto – las llamadas entrantes activan una búsqueda de contactos en HubSpot.
• Búsqueda de Contactos en HubSpot basado en Nombre, Número o Correo Electrónico si busca un nombre en el Cliente Web 3CX.
• Registro de Llamada y Chat – las llamadas y los chats se registran en la Tarjeta de Contacto de HubSpot como registros de llamadas de CRM.
• Crear un nuevo contacto HubSpot desde el cliente 3CX para llamadas desde nuevos números.
• Click to Call - realice llamadas directamente desde HubSpot a través de 3CX, utilizando las extensiones de navegador 3CX Click2Call para Google Chrome y Microsoft Edge.

Configurar HubSpot CRM con la CLI de HubSpot

HubSpot ha suspendido la creación de nuevas Aplicaciones Públicas heredadas desde la interfaz de la Plataforma para Desarrolladores. Ahora, las nuevas aplicaciones de HubSpot deben crearse utilizando el marco de Proyectos de HubSpot y la CLI de HubSpot.

Esta guía explica cómo crear la aplicación OAuth de HubSpot necesaria para la integración de 3CX con el CRM de HubSpot.

Nota: Las Aplicaciones Públicas heredadas existentes siguen funcionando.

Paso 1: Determinar la URL de Redirección de OAuth de 3CX

Antes de crear el proyecto de HubSpot, determine la URL pública que se utiliza para acceder al sistema 3CX.

Por ejemplo, si se accede a la Consola de Administración de 3CX a través de:

https://mypbx.3cx-example.com

...entonces la URL de redirección de OAuth de HubSpot debe ser:

https://mypbx.3cx-example.com/api/oauth2crm

Paso 2: Instalar la CLI de HubSpot

La CLI de HubSpot es una aplicación de Node.js, por lo que primero hay que instalar Node.js con npm.

HubSpot CLI 8 requiere Node.js 20 o una versión posterior.

• Abra un nuevo Símbolo del Sistema.
• En la Línea de Comandos, ejecute:

npm install -g @hubspot/cli@latest



• Cuando termine la instalación, revise la versión del CLI de HubSpot:

hs --version



• Debería aparecer una versión del CLI de HubSpot

Paso 3: Iniciar Sesión en HubSpot desde la CLI

• En la Línea de Comandos, ejecute:

hs account auth

La CLI le guiará a través del proceso de autenticación de su cuenta de HubSpot. Siga las instrucciones:

• Si se le solicita, asigne a la cuenta de HubSpot un nombre local que sea fácil de reconocer.
• Se abrirá una ventana del navegador, o bien la CLI mostrará instrucciones para abrir HubSpot.
• Inicie sesión en la cuenta de HubSpot en la que se creará el proyecto o la aplicación.

• Genere la Clave de Acceso Personal solicitada.
• La clave debería aparecer automáticamente en la ventana de la terminal.

• Si la CLI le pide que pegue la clave de acceso personal en la terminal, péguela y presione Enter.

• Ingrese un nombre de cuenta si se le solicita.
• Si se le pregunta si esta debe ser la cuenta predeterminada, seleccione Sí.

Paso 4: Crear el Proyecto OAuth de HubSpot

• En la Línea de Comandos

• Genere una carpeta para el proyecto, por ejemplo:

mkdir C:\HubSpotProjects

cd /d C:\HubSpotProjects



• En esta carpeta, ejecute:

hs project create --project-base app --distribution private --auth oauth



• La CLI le pedirá información adicional.

• Nombre del proyecto, ejemplo: "Integración de 3CX con HubSpot".
• Carpeta local, predeterminada o utilice algo sencillo como: "3cx-hubspot".
• Funciones

• La integración de 3CX con el CRM no requiere, por sí misma, una Tarjeta de Aplicación de HubSpot, un webhook, una acción de flujo de trabajo, una página de configuración ni ninguna otra función del proyecto. Si la CLI le pide que elija funciones, deje todas las opciones desmarcadas y continúe presionando Enter.

• Una vez que se complete el comando, debería aparecer un nuevo directorio, por ejemplo: "C:\HubSpotProjects\3cx-hubspot".
• Cambiese a ese directorio:

cd /d C:\HubSpotProjects\3cx-hubspot



• Los archivos importantes deben incluir:

C:\HubSpotProjects\3cx-hubspot\hsproject.json

C:\HubSpotProjects\3cx-hubspot\src\app\app-hsmeta.json

Paso 5: Configurar OAuth y los Alcances Necesarios para 3CX

Abra el siguiente archivo en el Bloc de notas: "C:\HubSpotProjects\3cx-hubspot\src\app\app-hsmeta.json".

El archivo generado puede contener propiedades adicionales que se pueden ignorar; la sección importante es la configuración de la aplicación y, en particular, la sección de autenticación.

Configure la aplicación con su distribución, los alcances requeridos (requiredScopes) y las URL de redirección (redirectUrls) como se muestra a continuación, sustituyendo "https://pbx.example.com/api/oauth2crm" por la URL pública real de 3CX determinada en el Paso 1.

{

  "uid": "3CXHubSpotIntegration_app",

  "type": "app",

  "config": {

    "description": "OAuth application for the 3CX HubSpot CRM integration",

    "name": "3CX HubSpot Integration-App",

    "distribution": "private",

    "auth": {

      "type": "oauth",

      "redirectUrls": [

        "https://pbx.example.com/api/oauth2crm"

      ],

      "requiredScopes": [

      "oath",

           "crm.objects.contacts.read",

                "crm.objects.contacts.write",

                "crm.objects.companies.read",

                "crm.objects.owners.read",

                "timeline"

      ],

      "optionalScopes": [],

      "conditionallyRequiredScopes": []

    },

    "permittedUrls": {

      "fetch": [

        "https://api.hubapi.com"

      ],

      "iframe": [],

      "img": []

    },

    "support": {

      "supportEmail": "[email protected]",

      "documentationUrl": "https://example.com/docs",

      "supportUrl": "https://example.com/support",

      "supportPhone": "+18005555555"

    }

  }

}

Paso 6: Valide y Suba el Proyecto a HubSpot

• Desde el directorio del proyecto, ejecute:

hs project validate



• Si la validación se realiza con éxito, continúe.

• Si la validación reporta un error, corrija la propiedad JSON indicada y vuelva a ejecutar el comando.

• Después, ejecute:

hs project upload



• La primera vez que se suba el proyecto, HubSpot podría mostrar un mensaje similar al siguiente:

• "El proyecto no existe en esta cuenta. ¿Desea crearlo?"

• Responda "Y" y siga adelante.

• La CLI hará lo siguiente:

• Subir los archivos.
• Crear una compilación de HubSpot.
• Implementar la aplicación.

Paso 7: Obtener el ID de Cliente y el Secreto de Cliente en HubSpot

• En su navegador, inicie sesión en su cuenta de HubSpot y vaya a Desarrollo > Proyectos.
• Abra la Integración de 3CX con HubSpot (o el nombre del proyecto que haya creado).
• En Componentes del Proyecto, haga clic en el nombre de la aplicación.
• Abra la pestaña Auth.

• HubSpot mostrará las siguientes credenciales del Cliente:

• ID del Cliente.
• Secreto del Cliente.

• Copie ambos valores en un lugar seguro.

Paso 8: Agregue Cuentas Adicionales de HubSpot CRM a la Aplicación Privada de OAuth (Opcional)

Este es un nuevo paso importante en comparación con el antiguo procedimiento de la Aplicación Pública.

Dado que el proyecto se creó con "distribution": "private", HubSpot solo permite la autorización OAuth para cuentas que hayan sido aprobadas explícitamente. Por defecto, solo la cuenta que creó la Aplicación tiene acceso ("private").

En HubSpot:

• Abra Desarrollo.
• Abra Proyectos.
• Abra el proyecto 3CX.
• En Componentes del Proyecto, seleccione la aplicación 3CX.

• Abra la pestaña Distribución.

• Haga clic en Agregar cuenta(s) aprobada(s).
• En la lista de cuentas de producción disponibles, seleccione la cuenta de HubSpot CRM que contenga los contactos y las empresas que se integrarán con 3CX.

• Si su cuenta de HubSpot tiene acceso tanto a una cuenta de desarrollo como a la cuenta normal de CRM de la empresa, asegúrese de que la cuenta de CRM que contiene los datos reales de los clientes esté aprobada.

• Haga clic en Guardar cambios.

Configurar y Autorizar HubSpot en 3CX

• En la Consola de Administración 3CX, vaya a “Integraciones” > “CRM”.
• Seleccione “HubSpot” desde el menú desplegable.
• Seleccione el orden de búsqueda de contactos deseada.
• Introduzca los valores OAuth de "ID de Cliente" y "Cliente Secreto" previamente copiados de su aplicación.
• Haga clic en Guardar.
• Haga clic en Autorizar.

• Debería abrirse una página de autorización de HubSpot.

• Inicie sesión en HubSpot si es necesario.
• Seleccione la cuenta de HubSpot CRM que contenga los contactos y las empresas que 3CX debe utilizar.
• Revise los permisos solicitados.
• HubSpot podría advertirle que la aplicación no está verificada. Esto es normal en el caso de una aplicación creada por su cuenta y que no se ha enviado a HubSpot Marketplace.
• Confirme la instalación / autorización.

• 3CX ahora recibe el código de autorización de OAuth y lo convierte en tokens de OAuth de HubSpot.
• Verifique que el campo "Actualizar Token" se llene automáticamente para el CRM de HubSpot en la Consola de Administración de 3CX.
• Si desea habilitar la creación de contactos desde el cliente 3CX, marque esta opción. Cuando no sea posible asociar el número de la persona que llama a un contacto, el cliente 3CX le permitirá al usuario crear el contacto al ingresar los datos en un cuadro de diálogo.

Configurar los Contactos y el Identificador de Llamadas en e164

• Para obtener una coincidencia con HubSpot, el Identificador de Llamadas entrante debe ser idéntico a la entrada de CRM, incluido cualquier prefijo, ya que HubSpot realiza búsquedas de números enteros. La consulta a HubSpot utilizando un subconjunto de dígitos no devuelve ningún dato.
• Para que la integración con HubSpot funcione, debe almacenar los números en HubSpot utilizando el formato E164 y su Troncal SIP debe proporcionar el número de la persona que llama también en formato E164, para que ambos coincidan. Si este no es el caso, puede utilizar el Reformateo de Caller ID para ajustar el número de la persona que llama antes de pasarlo al CRM.
• Ahora, vaya a Sistema > Agenda > Opciones, establezca la estrategia de coincidencia a "Coincidir exactamente" y haga clic en "Aceptar".

Configurar el Registro de Llamadas y Chats, Incluida la Transcripción

• Para reportar llamadas externas y chats a HubSpot, la dirección de correo electrónico configurada para la extensión 3CX debe coincidir con la dirección de correo electrónico de un usuario HubSpot. De esta manera 3CX puede asociar la extensión 3CX que recibe la llamada o chat al usuario HubSpot.
• Marque la opción "Activar Registro de Llamadas" para notificar las llamadas externas al CRM, y configure estos parámetros de "Registro de Llamadas":

• Asunto de Llamada - asunto de la llamada.
• Llamada Entrante Contestada - descripción para llamadas entrantes contestadas.
• Llamada Perdida - descripción para llamadas perdidas.
• Llamada Saliente Contestada - descripción para llamadas salientes contestadas.
• Llamada Saliente No Contestada - descripción para llamadas salientes no contestadas.

• Tenga en cuenta que puede utilizar variables en los parámetros de "Registro de Llamadas", indicadas como
  [variable_name]
  , por ejemplo: el número externo se especifica cómo
  [Number]
  . Las variables disponibles se enumeran aquí.

• Si desea informar de los chats al CRM, marque la casilla Habilitar Registro de Chat y configure los parámetros que se indican a continuación:

• Asunto del Chat - el asunto de la sesión de chat.

• Tenga en cuenta que puede utilizar variables en los parámetros de "Registro de Chat", indicados como
  [variable_name]
  , por ejemplo: el número externo se especifica cómo
  [Number]
  . Las variables disponibles se enumeran aquí.

Ver También

• Vea cómo integrar su CRM con la API 3CX.
• Aprenda cómo configurar la integración Bitrix24.
• Aprenda cómo configurar la integración ConnectWise.
• Aprenda cómo configurar la integración Microsoft 365.
• Aprenda cómo configurar la integración Jetpack CRM.
• Aprenda cómo configurar la integración Salesforce.
• Aprenda cómo configurar la integración Zoho.

Última Actualización

Este documento se actualizó por última vez el 21 de Agosto de 2026

https://www.3cx.es/docs/integracion-crm-hubspot/