Go High Level
Cómo conectar Dapta con GHL
Last updated
Cómo conectar Dapta con GHL
Last updated
Consideraciones
En la medida de lo posible es mejor que el cliente nos invite al correo de la empresa con una cuenta como admin, ya que con esto hay mayor autonomía y más independencia para hacer las integraciones.
En estos momentos la API de GHL tiene dos versiones, en esta guia se hara un enfoque en la versión 2 ya que ofrece mas recursos y tiene funciones para mensajería. De igual manera se dejara el enlace para la documentación y la forma de obtener esa key.
Hay un dato que es el location id de la cuenta el cual es necesarios en varios servicios para poder ver la informacion. Una forma rapida de obtenerlo es desde la misma url del navegador obtener el id que esta ubicado despues del location
Extracción de la API Key
En la versión 2 para obtener la api key dentro de la cuenta de GHL en el sidebar principal hay una opción que se llama “Private Integration” o “Integraciones privadas” dependiendo del idioma de la cuenta
Al estar dentro de integraciones privadas se verá la opción para crear una nueva integración y ahí se pedirá el nombre y una breve descripción, esta ultima es opcional. Luego se le da en siguiente y lo que sigue es seleccionar los scopes que va a tener la API Key, lo cual ya depende de lo que se quiera hacer en cada implementación por lo general siempre es preferible mantener las acciones referentes a editar y ver contactos, todo lo referentes al calendario y ver y editar custom fields.
Una vez agregados los scopes se mostrará en la pantalla el api token el cual es de tipo bearer, esta clave hay que guardarla ya que al salir de esa pantalla no volverá a ser visible y en caso de que se pierda tocará generar otra.
Generación del token para la versión 1
Para la version 1 es un proceso un poco más rapido ya que es solo ir a la Configuración en el sidebar al seleccionar “Perfil de empresa” y luego en la siguiente sección se verá la clave
Casos de uso mas comunes de los clientes
Hay que aclarar que en la mayoría de implementaciones realizadas no requieren consultar una base de datos de leads o contactos, en estos casos son los webhooks los que inician los procesos ya que porque entró un nuevo lead, o se agendó una reunión que entró y esto implica que se ejecuten las llamadas para contactar a los clientes.
Antes de entrar en detalle sobre los distintos requerimientos que pueden existir dentro del CRM, es importante mencionar los Automations que son los triggers que nos van a ayudar a que los flujos de Dapta se ejecuten para realizar las llamadas o cualquier otra acción
Luego se verá un tablero con los workflows creados y a la derecha se podrá encontrar la opcion para crear un flujo de trabajo y por lo general se selecciona “Empezar desde cero”
Todo comienza desde el primer nodo “Trigger” y ahi se selecciona el tipo que evento que va a ejecutar el flujo de Dapta
Si el caso de uso es por ejemplo que un lead (en go high level se llaman oportunidades) ingresa en un determinado estado y que se debe de llamar se hace lo siguiente en trigger
Los webhooks tienen filtros para hacer aun mas especifico el evento que se va a ejecutar, aca se pueden ver que el trigger es para cuando una oportunidad o lead es creado y se puede filtrar por el pipeline y el status
Otro trigger es cuando se agenda una cita y se quiere ejecutar un flujo en Dapta cuando alguien agenda en un calendario
Ahí se puede filtrar por el calendario y para estos casos donde se va a trabajar con un calendario para capturar eventos o hacer agendamientos en las llamadas es indispensable confirmar con el cliente cual es el calendario con el que se va a trabajar.
Otro caso también es cuando se quiere ejecutar un flujo cuando un tag es asociado a un contacto
Se busca el evento del tag de contacto y la accion de tag añadido y se puede seleccionar el tag especifico
Luego se enlaza el trigger con un nodo tipo webhook en donde se puede ingresar la url del flujo de Dapta
Ejemplos en Dapta de los webhooks
Oportunidad creada
(Organization id: c0857881-4f01-4ab7-bf5d-1da3f14a2238)
Cita agendada
(Organization id: ffe1d1e8-a179-4864-9d7c-7159d1c01000)
Tag agregado en un contacto
(Organization id: 4aab002a-1396-40bd-84f7-4b51ca2935bb)
Objeto de ejemplo
En GHL todos los webhooks envian una peticion POST con esta misma estructura
{
"contact_id": "GsqjTYJBXsI4jJLsESyM",
"first_name": "Santiago",
"last_name": "Ramirez",
"full_name": "Santiago Ramirez",
"email": "santiago.ramirez@daptatech.com",
"phone": "+573003588802",
"tags": "activar ia",
"country": "US",
"timezone": "America/Bogota",
"date_created": "2025-04-28T18:56:02.586Z",
"contact_source": "- -",
"full_address": "",
"contact_type": "lead",
"location": {
"name": "location test",
"address": "Address testt",
"city": "",
"state": "",
"country": "",
"postalCode": "",
"fullAddress": "",
"id": "location id"
},
"workflow": {
"id": "",
"name": "Dapta IA Tag"
},
"triggerData": {},
"contact": {
"attributionSource": {
"sessionSource": "CRM UI",
"medium": "manual",
"mediumId": null
},
"lastAttributionSource": {}
},
"attributionSource": {},
"customData": {}
}
En enlace con la documentación de la version 2 del API es este
En la enlace para la documentación de la version 1 es
