Documentación técnica.

La API de Malla expone los leads calificados, los inmuebles sincronizados y las conversaciones del agente. Todo en JSON, autenticado con un Bearer token. Cinco minutos para tu primer request.

1. Entra a tu dashboard → Configuración → API → Generar nueva llave.
2. Guarda la llave como variable de entorno (MALLA_API_KEY).
3. Haz tu primer request:

curl https://api.trymalla.live/v1/leads \
  -H "Authorization: Bearer ${MALLA_API_KEY}" \
  -G --data-urlencode "tone=hot" --data-urlencode "limit=25"

Todas las requests se autentican con un Bearer token en el header Authorization. No exponemos basic auth ni cookies — solo tokens.

Authorization: Bearer mlla_live_xxx...

Las llaves mlla_live_ operan contra tu cuenta real. Para pruebas usa mlla_test_ y el dataset de demo. Las llaves se rotan desde el dashboard; la anterior queda activa 24 horas para evitar caídas.

Base URL: https://api.trymalla.live. Versionamos en la URL — la v1 es estable, los breaking changes salen como v2.

La referencia completa con ejemplos por endpoint está en construcción. Por ahora, cualquier campo es predecible — pídenos un ejemplo a soporte si lo necesitas hoy.

Recibe eventos en tiempo real cuando algo importante pasa. Todos los webhooks vienen firmados con HMAC-SHA256 — verifica la firma antes de actuar.

// Verifica la firma del webhook
import crypto from 'node:crypto';

export function verifyWebhook(req) {
  const signature = req.headers['x-malla-signature'];
  const expected = crypto
    .createHmac('sha256', process.env.MALLA_WEBHOOK_SECRET)
    .update(req.rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected),
  );
}

El SDK oficial para Node.js / TypeScript: npm install @malla/sdk. Para Python, Ruby y Go usamos OpenAPI — descarga el spec en /v1/openapi.json y genera el cliente.

import { Malla } from '@malla/sdk';

const malla = new Malla({ apiKey: process.env.MALLA_API_KEY });

// Listar leads calientes de la última semana
const leads = await malla.leads.list({
  tone: 'hot',
  since: '7d',
  limit: 25,
});

for (const lead of leads.data) {
  console.log(`${lead.score} · ${lead.name} · ${lead.budget}`);
}

Por defecto: 600 requests / minuto por llave. Cuando lo excedes, respondemos 429 Too Many Requests con el header Retry-After. Para volúmenes mayores escríbenos.