Agil API

curl https://api.workagil.com/v1/cuenta \
  -H "Authorization: Bearer wa_test_TU_LLAVE"

// Node 18 o más nuevo (fetch viene incluido)
const respuesta = await fetch('https://api.workagil.com/v1/cuenta', {
  headers: { Authorization: `Bearer ${process.env.WORKAGIL_LLAVE}` },
});
console.log(respuesta.status, await respuesta.json());

import os, requests

respuesta = requests.get(
    "https://api.workagil.com/v1/cuenta",
    headers={"Authorization": f"Bearer {os.environ['WORKAGIL_LLAVE']}"},
    timeout=20,
)
print(respuesta.status_code, respuesta.json())

<?php
$ch = curl_init('https://api.workagil.com/v1/cuenta');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('WORKAGIL_LLAVE')],
    CURLOPT_RETURNTRANSFER => true,
]);
$cuerpo = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), ' ', $cuerpo;

curl https://api.workagil.com/v1/sms \
  -H "Authorization: Bearer wa_test_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-98231" \
  -d '{"para": "+573001234567", "texto": "Hola Laura, tu pedido 98231 sale hoy.", "referencia": "pedido-98231"}'

const respuesta = await fetch('https://api.workagil.com/v1/sms', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORKAGIL_LLAVE}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'pedido-98231',
  },
  body: JSON.stringify({
    para: '+573001234567',
    texto: 'Hola Laura, tu pedido 98231 sale hoy.',
    referencia: 'pedido-98231',
  }),
});
const sms = await respuesta.json();
console.log(respuesta.status, sms.id, sms.estado);

import os, requests

respuesta = requests.post(
    "https://api.workagil.com/v1/sms",
    headers={
        "Authorization": f"Bearer {os.environ['WORKAGIL_LLAVE']}",
        "Idempotency-Key": "pedido-98231",
    },
    json={
        "para": "+573001234567",
        "texto": "Hola Laura, tu pedido 98231 sale hoy.",
        "referencia": "pedido-98231",
    },
    timeout=30,
)
sms = respuesta.json()
print(respuesta.status_code, sms["id"], sms["estado"])

<?php
$ch = curl_init('https://api.workagil.com/v1/sms');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('WORKAGIL_LLAVE'),
        'Content-Type: application/json',
        'Idempotency-Key: pedido-98231',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'para' => '+573001234567',
        'texto' => 'Hola Laura, tu pedido 98231 sale hoy.',
        'referencia' => 'pedido-98231',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$sms = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), ' ', $sms['id'], ' ', $sms['estado'];

Authorization: Bearer wa_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "error": {
    "codigo": "telefono_invalido",
    "mensaje": "El número no es válido. Usa el formato internacional (+573001234567), o manda pais: \"CO\".",
    "campo": "para"
  }
}

{
  "llave": { "nombre": "CRM Bogotá", "modo": "prueba", "permisos": ["sms"] },
  "empresa": { "id": 35, "nombre": "Muebles Laura", "plan": "Solo API" },
  "servicios": ["agil-blast", "agil-api"]
}

{
  "id": "sms_21",
  "para": "+573001234567",
  "texto": "Hola Laura, tu pedido 98231 sale hoy.",
  "estado": "enviado",
  "en_operador": false,
  "partes": 1,
  "referencia": "pedido-98231",
  "origen": "api",
  "campana": null,
  "prueba": false,
  "creado": "2026-10-28T16:30:39.857Z",
  "entregado": null,
  "motivo": null
}

curl https://api.workagil.com/v1/sms/lote \
  -H "Authorization: Bearer wa_test_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: promo-octubre" \
  -d '{
    "texto": "Promo de octubre: 20% en salas. Responde SALIR para no recibir mas.",
    "pais": "CO",
    "mensajes": [
      { "para": "3001112233", "referencia": "cliente-77" },
      { "para": "3004445566", "referencia": "cliente-78" },
      { "para": "3007778899", "texto": "Laura, tu sala ya llego a la tienda." }
    ]
  }'

const respuesta = await fetch('https://api.workagil.com/v1/sms/lote', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORKAGIL_LLAVE}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'promo-octubre',
  },
  body: JSON.stringify({
    texto: 'Promo de octubre: 20% en salas. Responde SALIR para no recibir mas.',
    pais: 'CO',
    mensajes: clientes.map((c) => ({ para: c.celular, referencia: `cliente-${c.id}` })),
  }),
});
const lote = await respuesta.json();
console.log(`${lote.aceptados} aceptados, ${lote.rechazados} rechazados, ${lote.partes} partes`);
for (const m of lote.mensajes.filter((m) => m.error)) console.log(m.para, m.error.codigo);

respuesta = requests.post(
    "https://api.workagil.com/v1/sms/lote",
    headers={
        "Authorization": f"Bearer {os.environ['WORKAGIL_LLAVE']}",
        "Idempotency-Key": "promo-octubre",
    },
    json={
        "texto": "Promo de octubre: 20% en salas. Responde SALIR para no recibir mas.",
        "pais": "CO",
        "mensajes": [{"para": c["celular"], "referencia": f"cliente-{c['id']}"} for c in clientes],
    },
    timeout=60,
)
lote = respuesta.json()
print(lote["aceptados"], "aceptados,", lote["rechazados"], "rechazados")
for m in lote["mensajes"]:
    if "error" in m:
        print(m["para"], m["error"]["codigo"])

<?php
$mensajes = array_map(fn ($c) => ['para' => $c['celular'], 'referencia' => 'cliente-' . $c['id']], $clientes);
$ch = curl_init('https://api.workagil.com/v1/sms/lote');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('WORKAGIL_LLAVE'),
        'Content-Type: application/json',
        'Idempotency-Key: promo-octubre',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'texto' => 'Promo de octubre: 20% en salas. Responde SALIR para no recibir mas.',
        'pais' => 'CO',
        'mensajes' => $mensajes,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$lote = json_decode(curl_exec($ch), true);
echo "{$lote['aceptados']} aceptados, {$lote['rechazados']} rechazados\n";

{
  "total": 3,
  "aceptados": 2,
  "rechazados": 1,
  "partes": 2,
  "mensajes": [
    { "id": "sms_31", "para": "+573001112233", "estado": "enviado", "referencia": "cliente-77", "partes": 1, "...": "..." },
    { "para": "+573004445566", "referencia": "cliente-78",
      "error": { "codigo": "en_lista_no_llamar", "mensaje": "El número está en la lista de no llamar de la empresa." } },
    { "id": "sms_32", "para": "+573007778899", "estado": "enviado", "partes": 1, "...": "..." }
  ]
}

curl https://api.workagil.com/v1/sms/sms_21 \
  -H "Authorization: Bearer wa_test_TU_LLAVE"

const respuesta = await fetch('https://api.workagil.com/v1/sms/sms_21', {
  headers: { Authorization: `Bearer ${process.env.WORKAGIL_LLAVE}` },
});
const sms = await respuesta.json();
console.log(sms.estado, sms.en_operador, sms.motivo);

sms = requests.get(
    "https://api.workagil.com/v1/sms/sms_21",
    headers={"Authorization": f"Bearer {os.environ['WORKAGIL_LLAVE']}"},
    timeout=20,
).json()
print(sms["estado"], sms["en_operador"], sms["motivo"])

<?php
$ch = curl_init('https://api.workagil.com/v1/sms/sms_21');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('WORKAGIL_LLAVE')],
    CURLOPT_RETURNTRANSFER => true,
]);
$sms = json_decode(curl_exec($ch), true);
echo $sms['estado'];

curl "https://api.workagil.com/v1/sms?limite=50&estado=fallido&desde=2026-10-01" \
  -H "Authorization: Bearer wa_live_TU_LLAVE"

{
  "datos": [ { "id": "sms_120", "estado": "fallido", "motivo": "El operador móvil no lo entregó.", "...": "..." } ],
  "siguiente": "sms_71"
}

{ "sms": 4200 }

POST https://tu-sistema.com/webhooks/workagil
Content-Type: application/json
X-Webhook-Evento: sms.fallido
X-Webhook-Id: 3f1c5a9e-0b7d-4f2e-9a61-2d8e4c7b1a05
X-Webhook-Firma: t=1793205039,v1=5b1e0c…

{
  "id": "3f1c5a9e-0b7d-4f2e-9a61-2d8e4c7b1a05",
  "evento": "sms.fallido",
  "ocurrido_at": "2026-10-28T16:34:00.000Z",
  "datos": {
    "sms": {
      "id": "sms_21",
      "para": "+573001234567",
      "estado": "fallido",
      "motivo": "El operador móvil no lo entregó.",
      "referencia": "pedido-98231",
      "origen": "api",
      "prueba": false,
      "...": "el resto del objeto SMS"
    },
    "campana": null
  }
}

// Node con Express
const crypto = require('crypto');
const express = require('express');

function firmaValida(cuerpo, cabecera, secreto) {
  const partes = Object.fromEntries(cabecera.split(',').map((p) => p.split('=')));
  const t = Number(partes.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > 300) return false;
  const esperada = crypto.createHmac('sha256', secreto).update(`${t}.${cuerpo}`).digest();
  const recibida = Buffer.from(partes.v1 || '', 'hex');
  return recibida.length === esperada.length && crypto.timingSafeEqual(recibida, esperada);
}

const app = express();
// express.raw: el cuerpo llega tal cual, sin convertir.
app.post('/webhooks/workagil', express.raw({ type: 'application/json' }), (req, res) => {
  const cuerpo = req.body.toString('utf8');
  if (!firmaValida(cuerpo, req.get('X-Webhook-Firma') || '', process.env.WORKAGIL_WEBHOOK_SECRETO)) {
    return res.sendStatus(401);
  }
  const aviso = JSON.parse(cuerpo);
  if (aviso.evento === 'sms.fallido') {
    console.log('No llegó', aviso.datos.sms.referencia, aviso.datos.sms.motivo);
  }
  res.sendStatus(200);
});
app.listen(3000);

# Python con Flask
import hashlib, hmac, json, os, time
from flask import Flask, request

app = Flask(__name__)
SECRETO = os.environ["WORKAGIL_WEBHOOK_SECRETO"].encode()

def firma_valida(cuerpo: bytes, cabecera: str) -> bool:
    partes = dict(p.split("=", 1) for p in cabecera.split(",") if "=" in p)
    try:
        t = int(partes.get("t", ""))
    except ValueError:
        return False
    if abs(time.time() - t) > 300:
        return False
    esperada = hmac.new(SECRETO, f"{t}.".encode() + cuerpo, hashlib.sha256).hexdigest()
    return hmac.compare_digest(esperada, partes.get("v1", ""))

@app.post("/webhooks/workagil")
def webhook():
    cuerpo = request.get_data()  # tal como llegó
    if not firma_valida(cuerpo, request.headers.get("X-Webhook-Firma", "")):
        return "", 401
    aviso = json.loads(cuerpo)
    if aviso["evento"] == "sms.fallido":
        print("No llegó", aviso["datos"]["sms"]["referencia"])
    return "", 200

<?php
$secreto = getenv('WORKAGIL_WEBHOOK_SECRETO');
$cuerpo = file_get_contents('php://input'); // tal como llegó
$cabecera = $_SERVER['HTTP_X_WEBHOOK_FIRMA'] ?? '';

$partes = [];
foreach (explode(',', $cabecera) as $p) {
    [$clave, $valor] = array_pad(explode('=', $p, 2), 2, '');
    $partes[$clave] = $valor;
}
$t = (int) ($partes['t'] ?? 0);
$esperada = hash_hmac('sha256', $t . '.' . $cuerpo, $secreto);

if ($t === 0 || abs(time() - $t) > 300 || !hash_equals($esperada, $partes['v1'] ?? '')) {
    http_response_code(401);
    exit;
}

$aviso = json_decode($cuerpo, true);
if ($aviso['evento'] === 'sms.fallido') {
    error_log('No llegó ' . $aviso['datos']['sms']['referencia']);
}
http_response_code(200);