// DESARROLLADORES

Conectá Aliantic con tu IA y con tus herramientas

Tu ecosistema de relaciones no tiene por qué vivir solo adentro de una app. Podés preguntarle a tu asistente quién necesita seguimiento, dejar que registre los contactos por vos, y avisarle a tus herramientas cuando pasa algo. Todo con tokens que creás y revocás vos.

Servidor MCP

MCP es el protocolo que usan los asistentes para conectarse a herramientas externas. Aliantic expone tu ecosistema como un servidor MCP: tu asistente lo consulta, y si le das permiso, también lo opera.

Endpoint:  https://aliantic.ar/api/ai/mcp
Auth:      Authorization: Bearer <tu-token>

El token se crea en Configuración → Conectar con IA. En Claude: Configuración → Conectores → Agregar conector personalizado.

Los tokens son de solo lectura salvo que marques lo contrario al crearlos. Un token existente nunca gana permisos: si querés escritura, creás uno nuevo. No hay ninguna herramienta que borre datos.

API REST

Para herramientas que no hablan MCP: Zapier, Make, n8n o tu propio backend. Usa el mismo token que el MCP, con los mismos permisos y la misma revocación. Una llave menos que administrar.

# Listar tus relaciones (token de lectura alcanza)
curl https://aliantic.ar/api/v1/relationships \
  -H "Authorization: Bearer $ALIANTIC_TOKEN"

# Sumar una relación (necesita token con escritura)
curl -X POST https://aliantic.ar/api/v1/relationships \
  -H "Authorization: Bearer $ALIANTIC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Distribuidora del Sur","type":"proveedor"}'

# Registrar que hablaste con alguien (por nombre o por id)
curl -X POST https://aliantic.ar/api/v1/contacts \
  -H "Authorization: Bearer $ALIANTIC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Distribuidora del Sur","note":"Reunión por el acuerdo"}'

Crear una relación es idempotente por nombre: si ya existe, devuelve 409 con el id en vez de duplicarla — una automatización que reintenta no ensucia tu ecosistema. Si un nombre es ambiguo, también devuelve 409 con los ids, en vez de elegir una al azar.

Webhooks

Aliantic le avisa a tu sistema cuando algo pasa, así no tenés que ir a preguntar. Se registran en Configuración → Webhooks y sirven para enchufar Zapier, Make, n8n o tu propio backend.

Verificar que el evento salió de Aliantic

Cada request trae la firma en X-Aliantic-Signature y el momento en X-Aliantic-Timestamp. La firma es un HMAC-SHA256 de timestamp.payload con el secret que te mostramos al crear el webhook. El timestamp entra en la firma para que reusar una vieja no sirva.

import { createHmac, timingSafeEqual } from "node:crypto";

function esDeAliantic(req, rawBody, secret) {
  const ts   = req.headers["x-aliantic-timestamp"];
  const sig  = req.headers["x-aliantic-signature"];
  const mio  = createHmac("sha256", secret).update(`${ts}.${rawBody}`).digest("hex");

  const a = Buffer.from(mio), b = Buffer.from(sig);
  // Comparar con === filtra información por el tiempo que tarda en fallar.
  return a.length === b.length && timingSafeEqual(a, b);
}

Esperamos un 2xx dentro de 5 segundos. Si un endpoint falla 10 veces seguidas se desactiva solo, y lo vas a ver marcado en Configuración.