💡Lo que aprenderás con este artículo:
cómo enviar un webhook
cómo recibir un webhook
cómo actualizar negocios a través de un webhook
¿Qué es un Webhook?
Los Webhooks funcionan como mensajeros, permitiendo que Clint se comunique de manera inteligente con otras herramientas, enviando y recibiendo información. Los cambios de estatus o etapa representan hitos en el recorrido del cliente, como una compra o la entrada en un grupo de WhatsApp. Clint puede tanto recibir datos de otras herramientas para actualizar contactos y negocios, como enviar información a otras herramientas basada en eventos predefinidos, como los cambios de estatus, por ejemplo.
¿Cómo integrar otras herramientas con Clint a través de webhook?
Paso 1: Después de iniciar sesión en Clint, en la pantalla inicial haz clic en "Más", o directamente en la fuente que deseas, entrando en el engranaje de configuraciones.
Paso 2: Haz clic en la pestaña "Integraciones" y luego en "+Nueva Integración".
Paso 3: Haz clic en "Webhook".
Paso 4: Elige si deseas "Recibir" o "Enviar" información a través de webhook y haz clic en "Comenzar".
Recibir webhook
Después de seleccionar "Recibir webhook", podemos definir si queremos crear/actualizar contactos o negocios y asignar un nombre a la integración.
Importante resaltar aquí que tenemos algunas posibilidades:
Crear negocio: Cada vez que recibamos un webhook, independientemente de si existe o no un negocio con el mismo contacto (Correo electrónico y/o Teléfono) ya creado en el origen, se creará un nuevo negocio.
Actualizar negocio: Cada vez que recibamos un webhook y exista un negocio con el mismo contacto (Correo electrónico y/o Teléfono) ya creado en el origen, solo se actualizará.
Crear o actualizar negocio: Cada vez que recibamos un webhook y no exista un negocio con el contacto ya creado en el origen, se creará uno nuevo. Si ya existe un negocio con el mismo contacto (Correo electrónico y/o Teléfono), el negocio será actualizado.
Después de crear la integración, obtendremos la URL para conectar con otras plataformas.
En la actualización de negocio es posible:
➡️ Cambiar el negocio de la etapa de embudo
Cómo: Debemos recibir el valor del webhook con el nombre o la posición de la etapa.
Valor: "Prospección" o "2"
Ejemplo: La tarjeta del negocio puede cambiar de la etapa base a prospección.
➡️ Adicionar un dueño del negocio
Cómo: Debemos recibir el valor del webhook con el correo electrónico del usuario que queremos definir como dueño.
Valor: nomedocontato@gmail.com
Ejemplo: Cuando el lead entre en Clint, tendrá automáticamente un dueño asignado para el negocio.
➡️ Cambiar de estado
Cómo: Debemos recibir el valor del webhook con el nombre del estado.
Ejemplo: Cuando el lead pase por una etapa X de la automatización, cambiará su estado de "Abierto" a "Ganado" en Clint.
➡️ Actualizar cualquier campo
Cómo: Podemos actualizar cualquier campo de contacto o negocio recibiendo este nuevo valor.
Ejemplo: Actualizar el campo de interés conforme la conversión en el formulario.
Para que esto ocurra, haga el mapeo de los campos en los que desea recibir la información en Clint y haga clic en "Continuar".
En la columna de la izquierda está el nombre del campo de la herramienta que está enviando el webhook.
En la columna de la derecha está el campo que vas a mapear en Clint (estado del negocio, dueño del negocio o etapa del embudo).
En la actualización de negocio, siempre necesitas mapear un campo de identificación, como el correo electrónico y/o el teléfono. De esta manera, el sistema identifica a qué contacto se está refiriendo.
Em configurações adicionais, no último passo, selecione uma tag para incluir nos negócios que chegarem através dessa integração. Aqui você também pode definir em qual etapa e status os negócios serão atribuídos.
Enviar webhook
Después de seleccionar "Enviar webhook", podemos definir qué desencadenante activará este webhook. Las opciones de desencadenante son las siguientes:
El negocio se crea
Entrar en una etapa
Cambiar de etapa
Cambiar de estado
Definido el gatillo de envío del webhook, ahora vamos a elegir un nombre para nuestra integración y agregar el enlace que hará la conexión entre las herramientas. En esta etapa, también necesitamos definir si el envío será a través de GET o POST.
GET: Cuando un webhook es activado usando el método GET, los datos se envían como parámetros en la URL. Estos parámetros son visibles en la barra de direcciones del navegador y pueden ser almacenados en cachés o registros del servidor. Como resultado, se recomienda que los datos confidenciales no se envíen a través de GET.
POST: Con el método POST, los datos se envían en el cuerpo de la solicitud HTTP, lo que significa que no son visibles en la barra de direcciones del navegador y no se almacenan en cachés ni en registros del servidor. El método POST es más seguro para el envío de datos confidenciales.
Clica en "Continuar".
En el mapeo vamos a definir qué información queremos enviar. Algunos campos se mostrarán y puedes editar el identificador del campo y eliminar los campos que no deseas enviar. Finaliza haciendo clic en 'Guardar'."
Algunos ejemplos de campos que puedes usar para enviar la información del cliente
Encontrarás estos campos en el grupo 'Configuraciones de negocio' al momento de seleccionar la información que deseas enviar."
📌 Importante:
Si el webhook de salida falla 3 veces consecutivas, el webhook se desactiva. Esto ocurre porque hay algo incorrecto en la configuración o algún problema en el lugar donde está intentando enviar la información.
Para integraciones entre orígenes en Clint, el estado del negocio siempre llegará como "Abierto".
En el Header de tu solicitud debe tener el Content-Type = application/json, ya que nuestro content-type está en este formato (observación para plataformas propias).