Zona de desarrolladores

Esta sección es para desarrolladores e integraciones técnicas. Si quieres usar WhatSetter en el día a día (campañas, conversaciones, reuniones), ve a las guías del dashboard.

Tres puertas de entrada

API REST

34 endpoints para leer tus leads y conversaciones, importar contactos, enviar mensajes por el motor anti-ban, controlar tus campañas, bloquear números y leer tus enlaces rastreados. Inicio rápido · Autenticación

Webhooks firmados

WhatSetter empuja los eventos a tu servidor en cuanto suceden: lead calificado, lead descartado, número desconectado. Cada entrega va firmada con HMAC-SHA256. Configurar los webhooks

Servidor MCP

34 herramientas para Claude, Cursor, VS Code, ChatGPT, Gemini CLI y Codex CLI. Tu asistente lee tus leads, importa contactos o bloquea un prefijo desde un chat. Conectar un asistente

Referencia de la API

Una página por endpoint, generada desde la spec OpenAPI 3.1, con esquemas, ejemplos y una consola “Try it”. Abrir la referencia

Guías por recurso

Cada guía muestra la misma petición en cURL, JavaScript y Python, la respuesta que recibes y los errores que importan para ese endpoint.

LeadsLeer, filtrar, actualizar, asignar, pasar a un humano, añadir notas.

Listas e importaciónCrear una lista y subir hasta 500 contactos por llamada.

CampañasListar, pausar, reanudar, añadir un lead opt-in.

MensajesEnviar un mensaje de WhatsApp a un lead con el que ya hablas.

ConversacionesBandeja de entrada e historial completo de mensajes.

ReunionesReuniones agendadas por el agente.

GruposGrupos de WhatsApp rastreados: miembros, mensajes, entradas y salidas.

Contactos bloqueadosNúmeros y prefijos que el agente ignora.

EquipoMiembros del espacio, para asignar leads.

Enlaces rastreadosTus enlaces de WhatsApp y sus estadísticas de clics.

Principios

• Una sola clave para todo. La misma clave ws_live_… sirve para la API REST y el servidor MCP. Revócala y ambos se detienen en menos de un minuto.
• Scopes. Cada clave lleva permisos (leads:read, messages:send, blocklist:manage, etc.). Concede a cada integración el mínimo que necesita. Mira Autenticación y permisos.
• El anti-ban no se puede eludir. La API aplica las mismas protecciones que el dashboard: sin contacto en frío por POST /messages, una cuota diaria por número de WhatsApp, envíos humanizados.
• Un solo sobre de error. Cada error es { "error": { "code": "…", "message": "…" } } con un code estable. Mira Errores, límites e idempotencia.
• Solo tu espacio. Una clave solo ve su propio espacio. Un id que pertenece a otro espacio responde 404, nunca 403.

En cifras

Qué	Cantidad
Endpoints REST	34
Herramientas MCP	34
Scopes	14, más Acceso completo
Eventos de webhook	5, de los cuales 3 se emiten hoy

Relacionado

• Usar estos docs con asistentes IA
• Errores, límites e idempotencia
• Servidor MCP
• Referencia de la API