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.