API de Sendveo

La API de Sendveo permite que tus sistemas conecten números de WhatsApp, envíen y reciban mensajes, y transmitan los mensajes entrantes a tu propio endpoint, todo bajo tu cuenta de Sendveo. Es una API REST pequeña y predecible que habla JSON sobre HTTPS.

Introducción

Cada solicitud se autentica con una clave de API que creas en el panel. Las respuestas son JSON, los errores comparten un mismo envoltorio y los identificadores son cadenas opacas que puedes almacenar tal cual.

URL base

Todos los endpoints residen bajo una única URL base versionada:

URL base
https://api.sendveo.com/v1

Las rutas de esta referencia son relativas a esa base, por ejemplo /numbers es https://api.sendveo.com/v1/numbers.

Inicio rápido

Envía tu primera solicitud. Lista los números de tu cuenta:

GET/v1/numbers
cURL
curl https://api.sendveo.com/v1/numbers \
  -H "X-API-KEY: sv_live_your_key_here"

Una respuesta exitosa:

200 OK
{
  "numbers": [
    {
      "id": "chn_sales01",
      "displayName": "Sales line",
      "declaredNumber": "+212661234567",
      "pairedNumber": "+212661234567",
      "status": "CONNECTED",
      "connectedAt": "2026-08-19T09:12:00Z"
    }
  ]
}

Actualizaciones en vivo en el panel

El panel de Sendveo se mantiene al día mientras está abierto: los ticks de entrega avanzan, aparecen las reacciones y las ediciones, los mensajes nuevos llegan a la lista con sus contadores de no leídos, y un número que cambia de estado se ve al instante. Lee un stream en GET /app/events que lleva los mismos dieciséis eventos que lleva el webhook, con las mismas formas. Para tus propios sistemas el webhook es el canal que hay que usar, porque es duradero y reintentable; el stream es para un navegador con una sesión del panel abierta.

Convenciones

Los números de teléfono usan E.164 (un + inicial y el código de país). Las marcas de tiempo son ISO 8601 en UTC. Los identificadores son cadenas opacas; los recuentos son números. Todos los endpoints de lista devuelven un objeto con un array con nombre, nunca un array simple.

La facturación es de solo lectura a través de la API: el endpoint de facturación devuelve tus plazas (con tarjeta y con saldo, permitidas y en uso) y el saldo disponible de tu cuenta. Para comprar con tarjeta, activar números con tu saldo o consultar tu historial de cargos y abonos, usa la página Facturación del panel.

Documentación de la API de Sendveo: WhatsApp por REST