API de Clic+

Envía campañas de WhatsApp y Email desde tus propias herramientas (n8n, Zapier, Make) o tu sistema. La API está disponible para cuentas con plan Empresarial.

1. Autenticación

Todas las peticiones requieren tu API key, que obtienes en tu panel: menú de usuario → Mi API → Generar key.

Envía la key en el header de autorización:

Authorization: Bearer clic_live_tu_key_aqui

2. Enviar WhatsApp

Cuerpo (JSON):

{
  "numero": "573001112233",
  "mensaje": "Hola, gracias por tu compra."
}

Ejemplo con curl:

curl -X POST https://clicmas.pro/api/v1/whatsapp/send \
  -H "Authorization: Bearer clic_live_tu_key" \
  -H "Content-Type: application/json" \
  -d '{"numero":"573001112233","mensaje":"Hola!"}'

3. Enviar Email

Cuerpo (JSON):

{
  "empresa": "Mi Empresa",
  "asunto": "Novedades de esta semana",
  "mensaje": "Tenemos ofertas especiales para ti.",
  "correos": ["cliente1@correo.com", "cliente2@correo.com"]
}

Ejemplo con curl:

curl -X POST https://clicmas.pro/api/v1/email/send \
  -H "Authorization: Bearer clic_live_tu_key" \
  -H "Content-Type: application/json" \
  -d '{"empresa":"Mi Empresa","asunto":"Hola","mensaje":"Texto","correos":["a@a.com"]}'

4. Consultar saldo

Respuesta (JSON):

{
  "exito": true,
  "whatsapp": { "saldo": 5000, "plan": "Empresarial" },
  "email": { "correos_usados": 0, "creditos_correos": 0, "plan": "empresarial" }
}

5. Códigos de respuesta

• 200 — Éxito.
• 401 — API key inválida.
• 402 — Sin saldo disponible.
• 403 — Tu plan no incluye la API (requiere Empresarial).
• 409 — WhatsApp no conectado.
• 400 — Faltan datos en la petición.