Make

Armá un escenario que se dispara solo cuando pasa algo en tu cuenta de Kaptativa, por ejemplo una consulta nueva, y que escribe en una planilla, manda un mensaje o consulta datos a la API.

Para qué sirve

Make es un servicio donde se conectan aplicaciones arrastrando módulos, sin programar. Kaptativa se conecta con dos módulos que Make ya trae: Webhooks, para recibir un aviso cuando pasa algo, y HTTP, para pedirle datos a la API.

Esta guía arma un escenario con el evento inmobiliaria.consulta.recibida («Consulta recibida»). Los datos que trae son consulta_id, sobre y canal. Con el mismo método sirve cualquier otro evento de la lista de Webhooks.

Qué necesitás

Una cuenta de Make. El plan gratuito alcanza para probar.
Una cuenta de Kaptativa con API y MCP activo y permiso para crear destinos de webhook.
Para el paso de la API: un token de Solo ver, creado en Administración > API y MCP con Crear el token. Empieza con kpt_; en esta guía lo escribimos kpt_....

Pasos

1. Crear el webhook en Make

En Make, tocá Create a new scenario.
Tocá el signo más grande, buscá Webhooks y elegí el módulo Custom webhook.
En Webhook, tocá Add, ponele un nombre como «Kaptativa consultas» y guardá con Save.
Make muestra una dirección larga que empieza con https://hook.. Tocá Copy address to clipboard.
En el módulo, activá Get request headers: así podés ver el webhook-id de cada aviso, que sirve para no procesar el mismo dos veces.

2. Registrar esa dirección en Kaptativa

En el panel, abrí Administración > API y MCP y tocá Webhooks.
En Agregar un destino, ponele un nombre, pegá la dirección de Make y elegí el evento inmobiliaria.consulta.recibida. Tocá Agregar el destino.
Guardá el secreto que empieza con whsec_: se muestra una sola vez. En Make no lo vas a usar (más abajo está el porqué), pero guardalo por si cambiás de herramienta.
Tocá Probar en el destino. Kaptativa manda un aviso webhook.prueba a Make.

3. Que Make aprenda la forma del aviso

Volvé a Make y tocá Run once en el módulo del webhook: queda esperando un aviso.
Tocá Probar otra vez en Kaptativa. Make recibe el aviso y muestra sus campos. Es el evento de prueba, con un mensaje y no con los datos de una consulta.
Para que Make conozca los campos reales, cargá una consulta de verdad (por ejemplo, desde el formulario de contacto del sitio) mientras Make espera, o hacé clic derecho en el módulo y elegí Re-determine data structure y repetí. Los campos reales son los de datos: consulta_id, sobre, canal.

4. Escribir en Google Sheets

Tocá el signo más a la derecha del webhook, buscá Google Sheets y elegí Add a Row. En el primer uso, conectá tu cuenta de Google con Add y aceptá los permisos.
Elegí la planilla y la hoja. En cada columna, arrastrá el dato del aviso: datos.consulta_id, datos.sobre, datos.canal y, para la fecha, creado.
En Value input option, elegí Raw: así lo que llegue se guarda como texto y no se interpreta como fórmula.
Abajo a la izquierda, tocá Scheduling y dejalo en Immediately. Activá el escenario con el interruptor Scenario on/off.

5. Opcional: pedirle datos a la API con el módulo HTTP

Para sumar la persona, el asesor o el mensaje, agregá entre el webhook y la planilla un módulo HTTP > Make a request:

Campos del módulo HTTP de Make
Campo	Qué poner
URL	`https://panel.kaptativa.app/api/v1/inmobiliaria/consultas?estado=abiertas&limite=25`
Method	`GET`
Headers	Tocá Add a header. Name: `Authorization`. Value: `Bearer kpt_...`.
Parse response	Yes, para que Make separe los campos de la respuesta.
Evaluate all states as errors	Yes: un 401 o un 429 corta el escenario en lugar de seguir con datos vacíos.

Lo mismo en curl, para probarlo antes desde una terminal:

El mismo pedido con curl

curl "https://panel.kaptativa.app/api/v1/inmobiliaria/consultas?estado=abiertas&limite=25" \
  -H "Authorization: Bearer kpt_..."

La respuesta trae datos, con una entrada por consulta (numero, persona, propiedad, canal, estado, asesor, demorada y mensaje), y paginacion. Hay un detalle: la API lista consultas y no deja buscar una por el consulta_id del aviso, así que este módulo sirve para traer las abiertas, no para ubicar la que disparó el aviso. Si necesitás la ficha completa de cada consulta en la planilla, usá el camino de Apps Script.

Cualquier otra operación se llama igual. La referencia trae la ruta, los campos y un ejemplo de cada una, y /openapi.json se puede importar si preferís armar los módulos desde la descripción de la API. Una operación que cambia algo (POST o PATCH) pide además Idempotency-Key: ver Idempotencia. Todas cuentan contra el límite de 120 pedidos por minuto del token.

La firma: cuándo hace falta y por qué en Make casi no se usa

Cada aviso trae una firma (webhook-signature) con la que se comprueba que lo mandó Kaptativa y que nadie tocó el cuerpo. Se calcula sobre el texto exacto que viajó (ver Verificar la firma).

El problema con Make es que su módulo de webhook entrega el cuerpo ya separado en campos y no el texto original. Si se vuelve a armar el JSON, cambian espacios y orden y la firma no coincide, aunque el aviso sea legítimo. Por eso, en Make, verificar la firma no es un paso confiable. Lo que sí podés hacer:

Tratar el aviso como un timbre y no como la verdad. Si el escenario actúa a partir de un dato que sale de la API (con tu token) y no de lo que dice el aviso, un aviso falso no puede hacer daño: a lo sumo dispara una consulta de más.
Mantener la dirección en secreto. La dirección de Make lleva un código largo que nadie adivina. No la pegues en documentos compartidos ni en capturas. Si se filtra, en Make creá otro webhook y cambiá la dirección del destino en Kaptativa (el destino pasa a recibir en la nueva en el momento).
No dar acciones sensibles al aviso solo. Para algo que mueve plata o borra datos, usá n8n, que sí puede verificar la firma, o un pequeño servidor tuyo con el ejemplo de la página de Webhooks.

Qué no viaja en un aviso

Un aviso trae identificadores y lo que cambió. No trae nombres, emails ni teléfonos, de modo que robar la dirección de Make no expone datos de tus clientes.

Para no procesar el mismo aviso dos veces (un reintento o un reenvío llegan idénticos), usá el encabezado webhook-id: en Make, guardalo en un Data store y cortá el escenario con un filtro si ya está.

Cómo comprobar que anda

Con el escenario activo, tocá Probar en el destino del panel.
En Make, abrí History del escenario: tiene que haber una ejecución con una marca verde.
En Kaptativa, abrí el Registro de entregas del destino (con Actualizar): el estado tiene que ser Entregada y el código 200.
Cargá una consulta real y verificá que la fila llega a la planilla con el código de la propiedad en sobre.

Problemas comunes

Problemas comunes con Make
Qué pasa	Por qué y qué hacer
Kaptativa no deja guardar la dirección	La dirección tiene que ser `https` pública, sin puerto ni usuario. La que da Make cumple; si la editaste, copiala de nuevo.
Make no recibe nada	Chequeá que el escenario esté activo (o en Run once mientras probás) y que el destino tenga marcado `inmobiliaria.consulta.recibida` y no esté Pausado ni Suspendido. Un destino que falla varias veces seguidas se suspende: tocá Reanudar.
Los campos del aviso no aparecen para elegir	Make solo conoce lo que recibió. Mandá un aviso real con Run once encendido, o usá Re-determine data structure.
El módulo HTTP dice `401`	El token está mal escrito (tiene que ir como `Bearer kpt_...`, con un espacio), venció o se revocó.
El módulo HTTP dice `403` o `alcance`	El token no ve el módulo Inmobiliaria. Revisá sus alcances en Administración > API y MCP.
Llega dos veces el mismo aviso	Normal cuando algo tarda más de 10 segundos en responder: se reintenta con el mismo `webhook-id`. Descartá repetidos con ese dato.
La planilla guarda un texto como fórmula	Poné Value input option en Raw en el módulo de Google Sheets.

Si algo no responde como dice acá, abrí un ticket desde el panel y pegá el valor del encabezado x-kaptativa-pedido de la respuesta. La dirección de la API es https://panel.kaptativa.app/api/v1.