erp Centro de Ayuda

Inicio / Clientes / CRM - Leads

Imprimir
<< Anterior 2 / 2

Conectar Formulario Web con CRM Leads OBUMA

https://www.obuma.cl/ayuda/articulo/299

Para conectar tu formulario web o landing page con el CRM Leads de OBUMA:

 

Paso 1: Solicita tu token al dpto soporte de OBUMA.

Solo se entrega a empresas que tienen contratado el servicio API.

Este webhook entrante es similar a utilizar el endpoint de la API /crm.create.json

Debes comunicarte con el dpto de soporte por cualquiera de los canales de atención disponibles  solicitar el CRM Connector Token. 

 

Paso 2: Conecta el form al endpoint y envia por POST las siguientes variables:

Method: POST

URL endpoint : https://app.obuma.cl/obuma2.0/webservices/obuma_connector/leads.php (confirmar con dpto de soporte)

Tabla variables posibles a enviar:

variable descripcion obligatorio valores posibles
token Indicar el token entregado por OBUMA, que permite identificar y registrar el lead a cada empresa y/o campaña. si, entregado por OBUMA  
titulo nombre de la oportunidad si ( si es un formulario web de contacto repetir el campo empresa o contacto si no tiene este campo... ) varchar(100)
empresa nombre de la empresa de la oportunidad    varchar(100)
contacto nombre del contacto del lead    varchar(100)
contacto_cargo nombre del cargo    varchar(100)
telefono telefono del contacto del lead    varchar(100)
celular celular del contacto del lead    varchar(100)
email email del contacto del lead    email
sitio_web sitio web del lead    url sitio web ej.: www.obuma.cl
       
ciudad ciudad del lead    varchar(100)
pais pais del lead    varchar(100)
       
mensaje Campo correspondiente al mensaje   text
       
id_campana Indicar el id de la campañá o formulario.   num
id_cliente Indicar el id_cliente en OBUMA.   num
rut_cliente Indicar el rut del cliente asociado al lead si no se tiene el id_cliente, o si se desea.    Ej.: 55.555.555-5

 

 

Integridad y seguridad del envio

X-Obuma-Signature ( Opcional )

El encabezado X-Obuma-Signature se utiliza para asegurar la integridad y autenticidad de los datos enviados desde el cliente a Obuma ERP mediante un mecanismo de firma HMAC. La firma se genera en el lado del cliente y se valida en el servidor para confirmar que los datos no han sido alterados durante el tránsito.

 

Composición

El encabezado X-Obuma-Signature contiene la firma HMAC generada a partir de ciertos campos clave del formulario (como contacto, email, y mensaje) y un token secreto específico para cada empresa. Esta firma asegura que los datos no hayan sido modificados entre el cliente y el servidor.

Ejemplo :

signature = contacto + email + mensaje;

$signature = $contacto . $email . $mensaje;

 

El Token secreto

El token secreto a usar para generar el HMAC se obtiene creando un api key nuevo y colocando en el endpoint "crm_webhook"

 

 

Ejemplo de Solicitud HTTP

curl -X POST {URL} \
-H "X-Obuma-Signature: 5d41402abc4b2a76b9719d911017c592" \
-F "contacto=John Doe" \
-F "email=john.doe@example.com" \
-F "mensaje=Estoy interesado en sus servicios" \
-F "telefono=123456789" \
-F "ciudad=Santiago" \
-F "pais=Chile" \
-F "token={crm_token_entregado}"
 

Errores Comunes

  1. Firma Inválida:

    • Ocurre si el cliente y el servidor no están generando la firma HMAC de la misma manera (por ejemplo, usando un orden de campos diferente o un token secreto incorrecto).

  2. Falta de datos :

    • Solo se registran los datos enviados.

 

 



<< Anterior 2 / 2