Documentación · API v1

API de waseller

Crea números de WhatsApp, envía mensajes y recibe cada evento en tu webhook, desde tu propio sistema.

Generar mi llavehttps://waseller.mx/api/v1
Contenido

Esta API permite a una empresa crear y administrar números de WhatsApp desde su propio sistema, sin entrar al panel, y enviar mensajes con ellos. Todos los números viven en tu cuenta de waseller y también puedes verlos en el panel.

Dirección base

https://waseller.mx/api/v1

Esta es la dirección actual. Si cambia, te avisaremos con anticipación. Todas las rutas de esta guía cuelgan de esa dirección.

Todas las peticiones y respuestas son JSON (Content-Type: application/json). El cuerpo máximo permitido es de 1 MB (si lo superas: 413).

Llaves de acceso

Hay dos tipos de llave, y cada una solo sirve para su tipo de ruta:

LlavePrefijoPara qué sirve
Llave de cuentawsk_Administrar números: crear, listar, QR, desconectar, borrar. Rutas /numbers...
Llave de númerowsn_Mensajería de UN número: enviar mensajes, consultar estado y contactos, leer los mensajes guardados

La llave wsk_ la generas y revocas tú mismo en el panel (Configuración > API); se muestra una sola vez.

Se envian siempre en el encabezado:

Authorization: Bearer wsk_TU_LLAVE

Reglas importantes:

  • Las llaves se muestran una sola vez: la llave wsn_ y el webhook_secret al crear el número, y la llave wsk_ cuando la generas. No podemos recuperarlas; guárdalas en un lugar seguro.
  • Si una llave wsn_ se filtra, rótala con POST /numbers/:id/rotate-key (la anterior deja de funcionar al instante).
  • Usar una llave wsn_ en una ruta de cuenta (o al reves) responde 401.
  • Un número con estado suspended responde 403 en todas las rutas de mensajería.

Rutas de cuenta (llave wsk_)

Estas rutas solo ven los números creados por API. Un número que no es de tu cuenta (o que creaste desde el panel) responde siempre 404, igual que uno que no existe, y no aparece en el listado.

Crear un número

POST/numbers

curl -X POST "https://waseller.mx/api/v1/numbers" \
  -H "Authorization: Bearer wsk_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"5215512345678","name":"Ventas Mexico","webhook_url":"https://tu-servidor.com/hooks/whatsapp"}'

Campos: phone_number (obligatorio, 8 a 15 dígitos con lada de país, sin +), name (opcional), webhook_url (opcional, https pública), plan (opcional: starter por defecto, o pro; cualquier otro valor responde 422), syncHistory (opcional, booleano, false por defecto; true pide el historial de WhatsApp al vincular, ver "Historial al vincular"; otro tipo de valor responde 400), offlineMessages (opcional, booleano, false por defecto; true entrega por webhook los mensajes que llegaron sin conexión, ver "Mensajes que llegaron sin conexión"; otro tipo de valor responde 400). El plan define el precio, ver "Facturación".

Respuesta 201:

{
  "success": true,
  "data": {
    "id": "0b7f3c1e-6a9a-4c1c-9a57-5d2f0e8c1a11",
    "phone_number": "5215512345678",
    "name": "Ventas Mexico",
    "status": "pending",
    "webhook_url": "https://tu-servidor.com/hooks/whatsapp",
    "created_at": "2026-10-19T15:00:00.000Z",
    "api_key": "wsn_...",
    "webhook_secret": "whsec_..."
  }
}

api_key y webhook_secret aparecen solo en esta respuesta. Si el teléfono ya está registrado en la plataforma (o no está disponible) responde 409 con Number unavailable.

Límites: cada cuenta puede tener como máximo 10 números pendientes (todo número de tu cuenta que no esté connected: pending, connecting, disconnected...); al llegar al tope, crear otro responde 429. Solo se liberan solos, al crear un número nuevo, los números de tu cuenta con más de 24 horas que nunca se conectaron (estado pending o connecting, sin mensajes ni envíos); un número que alguna vez funcionó, aunque hoy esté disconnected, jamás se libera solo (cuenta para el tope hasta que lo borres). También se libera así el teléfono si lo reutilizas. Nunca se libera un número de otra cuenta (responde 409). Si no podemos comprobar tu cuota responde 503; reintenta.

Después de crearlo, pide el QR para vincular el WhatsApp.

Listar números

GET/numbers

curl "https://waseller.mx/api/v1/numbers" \
  -H "Authorization: Bearer wsk_TU_LLAVE"

Respuesta 200: {"success":true,"data":[{"id","phone_number","name","status","webhook_url","created_at"}, ...]}.

Detalle de un número

GET/numbers/:id

curl "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO" \
  -H "Authorization: Bearer wsk_TU_LLAVE"

Respuesta 200: los mismos campos que el listado. status es el estado en vivo de la sesión (connected, NEED_SCAN, etc.). live_status repite ese valor, o es null si en este momento no se pudo consultar (en ese caso status es el último conocido).

Obtener el QR

GET/numbers/:id/qr (agrega ?image=1 para recibir el QR como imagen en lugar de texto)

curl "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO/qr" \
  -H "Authorization: Bearer wsk_TU_LLAVE"

Respuesta 200:

{ "success": true, "data": { "status": "NEED_SCAN", "qrCode": "2@abc..." } }

Si el número ya está vinculado: status es connected y qrCode es null. Si el número está suspendido responde 403 (Number suspended). El QR caduca en unos 45 segundos; vuelve a pedirlo. Cuando se vincule recibirás el evento session.status en tu webhook.

Desconectar

POST/numbers/:id/disconnect

curl -X POST "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO/disconnect" \
  -H "Authorization: Bearer wsk_TU_LLAVE"

Respuesta 200: {"success":true}. Cierra la sesión pero conserva el número y su llave wsn_.

Reiniciar la sesión

POST/numbers/:id/restart

curl -X POST "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO/restart" \
  -H "Authorization: Bearer wsk_TU_LLAVE"

Respuesta 200: {"success":true}. Si el número está suspendido responde 403 (Number suspended).

Borrar un número

DELETE/numbers/:id

curl -X DELETE "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO" \
  -H "Authorization: Bearer wsk_TU_LLAVE"

Respuesta 200: {"success":true}. Cierra la sesión, revoca sus llaves y elimina el número. Solo aplica a números creados por la API.

Configurar el webhook de un número

PUT/numbers/:id/webhook

curl -X PUT "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO/webhook" \
  -H "Authorization: Bearer wsk_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://tu-servidor.com/hooks/whatsapp"}'

Para quitar el webhook envía {"url":null}. La URL debe ser https y pública; si no, responde 422. El webhook_secret del número no cambia.

Opcional: syncHistory (booleano) activa (true) o desactiva (false) el historial al vincular; si no lo envías, no cambia. Si envías solo {"syncHistory":true} (sin la llave url), tu url actual se conserva. Otro tipo de valor responde 400. Ver "Historial al vincular": debe quedar activado antes de escanear el QR.

Opcional: offlineMessages (booleano) activa (true) o desactiva (false) el evento messages.offline; si no lo envías, no cambia, y solo {"offlineMessages":true} conserva tu url. Se puede cambiar en cualquier momento, con el número ya vinculado y sin escanear el QR otra vez. Otro tipo de valor responde 400. Ver "Mensajes que llegaron sin conexión".

Rotar la llave de un número

POST/numbers/:id/rotate-key

curl -X POST "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO/rotate-key" \
  -H "Authorization: Bearer wsk_TU_LLAVE"

Respuesta 200: {"success":true,"data":{"id":"ID_DEL_NUMERO","api_key":"wsn_..."}}. La llave nueva se muestra una sola vez; las anteriores quedan revocadas.

Rutas de número (llave wsn_)

Operan sobre el número al que pertenece la llave. La respuesta es la del servicio de mensajería, tal cual (mismo código HTTP y mismos campos), más un campo warnings (lista; vacía si no hay avisos, ver "Avisos de uso"). Salvo GET /messages y GET /chats, que responde waseller con lo que tiene guardado (ver "Leer mensajes guardados").

Método y rutaPara qué sirve
POST /send-messageEnviar texto, archivo, ubicación, contacto o encuesta; responder citando
POST /send-presence-updateMostrar "escribiendo...", etc.
GET /on-whatsapp/:numeroSaber si un número tiene WhatsApp
GET /statusEstado de la conexión
GET /userDatos de tu número
POST /decrypt-mediaDescifrar un archivo recibido
POST /messages/read, POST /messages/reactMarcar como leído, reaccionar
PUT /messages/:msgId, DELETE /messages/:msgId, GET /messages/:msgId/infoEditar, borrar, consultar un mensaje
GET /contacts, GET /contacts/:numero, GET /contacts/:numero/pictureContactos y foto de perfil
PUT /contactsGuardar un contacto con nombre
POST /contacts/:numero/block, POST /contacts/:numero/unblockBloquear y desbloquear
GET /groups, POST /groups, /groups/:jid/...Listar, crear y administrar grupos
GET /labels, POST /labels, /labels/:id/chats...Etiquetas de WhatsApp Business: listar, crear, poner y quitar
POST /chats/:numero/archive, .../pin, .../mute, .../read (y sus contrarias)Archivar, fijar, silenciar y marcar leído/no leído un chat
POST /chats/:numero/historyPedir mensajes anteriores de un chat (llegan por webhook; requiere syncHistory)
POST /calls/:callId/rejectRechazar una llamada entrante
POST /presence/subscribeSaber si un contacto está en línea o escribiendo (llega como presence.update)
GET /webhook-eventsVer los últimos eventos (depurar tu webhook)
GET /messages?chat=..., GET /chatsLeer los mensajes y chats que waseller guardó de tu número

Cualquier otra ruta responde 404.

Enviar un mensaje de texto

POST/send-message

curl -X POST "https://waseller.mx/api/v1/send-message" \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"to":"5215598765432","text":"Hola, te escribimos desde waseller · waseller.mx"}'

Respuesta 200:

{
  "success": true,
  "data": { "msgId": "3EB0A1B2C3D4E5F6", "jid": "5215598765432", "status": "in_progress" },
  "warnings": []
}

Enviar un archivo por URL

POST/send-message

Usa uno de imageUrl, videoUrl, documentUrl, audioUrl o stickerUrl. La URL debe ser pública.

  • text (pie del archivo): solo con imagen, video y documento.
  • fileName y mimetype: solo con documento.
  • Audio: usa un archivo .m4a/.mp4 (AAC); se envía como audio de WhatsApp.
  • Sticker: usa una imagen .webp.
curl -X POST "https://waseller.mx/api/v1/send-message" \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"to":"5215598765432","documentUrl":"https://tu-servidor.com/cotizacion.pdf","fileName":"cotizacion.pdf","text":"Tu cotizacion"}'

Presencia ("escribiendo...", "grabando audio...")

POST/send-presence-update

Muestra al contacto que estás escribiendo o grabando un audio, como una persona real. Útil antes de que tu bot conteste.

curl -X POST "https://waseller.mx/api/v1/send-presence-update" \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"jid":"5215598765432","type":"composing"}'

Respuesta: {"success":true,"data":{"jid":"5215598765432@s.whatsapp.net","type":"composing"}}

  • jid: el número del contacto con lada, con o sin + (5215598765432, +5215598765432) o el JID completo (5215598765432@s.whatsapp.net).
  • type:
    • composing: "escribiendo..."
    • recording: "grabando audio..."
    • paused: quita el "escribiendo" sin mandar mensaje.
    • available / unavailable: en línea / fuera de línea.
  • El "escribiendo" dura unos 25 segundos en el teléfono del contacto o hasta que llegue tu mensaje. Si tu respuesta tarda más, vuelve a mandarlo cada ~10 segundos.
  • Con composing o recording tu número aparece "en línea" unos 30 segundos y luego vuelve a fuera de línea solo; no tienes que hacer nada.
  • Patrón recomendado: composing → espera 1-3 s (según el largo de la respuesta) → send-message. No hace falta mandar paused después: el mensaje lo quita.
  • Errores: 400 si la sesión no está conectada, 422 si falta jid/type o el número no tiene WhatsApp.

Verificar si un número tiene WhatsApp

GET/on-whatsapp/:numero

curl "https://waseller.mx/api/v1/on-whatsapp/5215598765432" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Respuesta: {"success":true,"data":{"exists":true},"warnings":[]}.

Estado de la conexión

GET/status

curl "https://waseller.mx/api/v1/status" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Respuesta: {"status":"connected","warnings":[]}.

Descifrar un archivo recibido

POST/decrypt-media

curl -X POST "https://waseller.mx/api/v1/decrypt-media" \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"data":{"messages":{"key":{"id":"ID_DEL_MENSAJE"},"message":{"imageMessage":{"url":"...","mediaKey":"...","mimetype":"image/jpeg"}}}}}'

Envía el bloque data.messages tal como lo recibiste en el evento messages.upsert de tu webhook. Responde {"success":true,"publicUrl":"https://..."} con un enlace temporal (24 horas) para descargar el archivo.

Responder citando, menciones y "ver una vez"

POST/send-message

Agrega estos campos a cualquier envío:

  • replyTo: el msgId de un mensaje reciente del chat (uno que enviaste o recibiste con este número). El mensaje sale como respuesta citada. Si no lo encontramos responde 422.
  • mentions: lista de números (con lada, sin +) o jids a mencionar en un grupo. Escribe también @numero en el text con el mismo número; nosotros lo ajustamos al formato que pide el grupo para que WhatsApp lo resalte.
  • viewOnce: true: la imagen, el video o el audio se puede ver una sola vez.
curl -X POST "https://waseller.mx/api/v1/send-message" \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"to":"5215598765432","text":"Claro, te confirmo el horario","replyTo":"3EB0A1B2C3D4E5F6"}'

Enviar ubicación, contacto o encuesta

POST/send-message

Usa uno de estos campos en lugar de text:

CampoFormaNotas
location{"latitude":19.4326,"longitude":-99.1332,"name":"Sucursal Centro","address":"Av. Juárez 10"}name y address son opcionales
contact{"name":"Ana López","phone":"5215512345678"}Llega como tarjeta de contacto que se puede guardar
poll{"question":"¿Qué día te acomoda?","options":["Lunes","Martes"],"multiSelect":false}De 2 a 12 opciones. Los votos llegan con el evento poll.results
curl -X POST "https://waseller.mx/api/v1/send-message" \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"to":"5215598765432","poll":{"question":"¿Qué día te acomoda?","options":["Lunes","Martes","Miércoles"]}}'

Mensajes: leído, reacción, editar, borrar e información

Estas rutas trabajan con mensajes recientes del número (guardamos los últimos 1000). El msgId es el que devuelve send-message o el key.id de los eventos.

Método y rutaCuerpoRespuesta
POST /messages/read{"key":{"id","remoteJid","fromMe"}} (la key del evento, tal cual){"success":true,"data":{"status":"read"}}
POST /messages/react{"key":{...},"text":"👍"} ("" quita la reacción){"success":true,"data":{"success":true,"message":"Message reaction updated"}}
PUT /messages/:msgId{"text":"Nuevo texto"}{"success":true,"data":{"msgId","key","text"}}
DELETE /messages/:msgId—{"success":true,"message":"Message deleted successfully."}
GET /messages/:msgId/info—{"success":true,"data":{"remoteJid","id","msgId","key","message","messageTimestamp","status"}}
  • Editar solo funciona con mensajes que envió este número; WhatsApp lo permite durante unos 15 minutos.
  • Borrar es "eliminar para todos". En un chat individual solo se pueden borrar mensajes propios.
  • Un msgId que no guardamos (muy viejo) responde 404.
  • info devuelve el mensaje como se envió o recibió; las ediciones posteriores no se reflejan ahí.
curl -X POST "https://waseller.mx/api/v1/messages/react" \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"key":{"id":"3EB0A1B2C3D4E5F6","remoteJid":"5215598765432@s.whatsapp.net","fromMe":false},"text":"👍"}'

Leer mensajes guardados

Lee lo que waseller ya guardó de tu número. No le pregunta nada al teléfono. Sirve para ponerte al día sin montar un servidor de webhook, o para darle contexto a tu agente antes de contestar.

GET/messages

ParámetroPara qué sirve
chatObligatorio. Teléfono con lada, sin +, de 8 a 15 dígitos, o un jid: ...@s.whatsapp.net, ...@lid, ...@g.us o ...@newsletter (un canal de WhatsApp) (escribe la @ como %40)
limitDe 1 a 100 mensajes (50 por defecto)
beforeSolo mensajes anteriores a ese momento: fecha ISO como 2026-11-08T15:00:00.000Z, o epoch en segundos o milisegundos. Si la fecha lleva un offset, encodea la + como %2B
curl "https://waseller.mx/api/v1/messages?chat=5215598765432&limit=2" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Respuesta 200, del más nuevo al más antiguo:

{
  "success": true,
  "data": [
    { "msgId": "3EB0A1B2C3D4E5F6", "direction": "out", "type": "text", "text": "Claro, te confirmo el horario", "timestamp": "2026-11-08T15:02:10.120Z", "status": "read" },
    { "msgId": "3EB0F6E5D4C3B2A1", "direction": "in", "type": "text", "text": "Hola, ¿tienen lugar mañana?", "timestamp": "2026-11-08T15:01:40.455Z" }
  ],
  "next_before": "2026-11-08T15:01:40.455Z",
  "warnings": []
}

Para ver la página anterior, pasa next_before como before:

curl "https://waseller.mx/api/v1/messages?chat=5215598765432&limit=2&before=2026-11-08T15:01:40.455Z" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Campos de cada mensaje:

  • msgId: el id del mensaje (null si no se guardó).
  • direction: in si lo recibió tu número, out si lo envió.
  • type: text, image, audio, video, document, location o contact. Los stickers salen como image.
  • text: el texto o el pie del archivo; null si no tiene.
  • timestamp: hora UTC en que waseller guardó el mensaje, que es cuando llegó (en los importados, la hora real del mensaje).
  • status: solo en los que envió tu número: sent, delivered o read.

GET/chats

Lista los chats del número, del más reciente al más antiguo. Acepta limit (de 1 a 100, 30 por defecto).

curl "https://waseller.mx/api/v1/chats?limit=10" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Respuesta 200:

{"success":true,"data":[{"chat":"5215598765432","name":"Ana López","last_message":{"direction":"out","type":"text","text":"Claro, te confirmo el horario","timestamp":"2026-11-08T15:02:10.120Z"}}],"warnings":[]}
  • chat es el valor que pasas a GET /messages?chat= (en un grupo, el jid del grupo).
  • name es el nombre que la persona tiene en su WhatsApp, o null.
  • last_message.text va recortado a 200 caracteres.

Reglas:

  • Solo hay mensajes desde que el número se vinculó a waseller, salvo que importes el historial anterior de WhatsApp (ver "Importar el historial a waseller"): el que entrega messaging-history.set o POST /chats/:numero/history llega por webhook y no se guarda solo.
  • Se pagina con before: mientras next_before no sea null hay más mensajes; pásalo como before en la siguiente llamada. null quiere decir que llegaste al principio.
  • En México el mismo contacto puede estar como 52... o 521...: con cualquiera de las dos ves el chat completo.
  • Un chat sin mensajes guardados responde data: [].
  • Los mensajes con archivo traen mediaUrl (enlace para descargarlo) cuando waseller lo guardó; si no viene, el archivo no se guardó.
  • Número suspendido: 403. chat, limit o before inválidos: 400. Llave wsk_: 401.

Contactos

GET/contacts

curl "https://waseller.mx/api/v1/contacts?paginated=true&page=1&limit=20" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Respuesta 200: {"success":true,"data":[{"jid":"5215598765432","name":"Ana López","notify":"Ana","verifiedName":null,"imgUrl":null,"status":null}]}. Con paginated=true agrega total, page y limit (máximo 100 por página); sin él, devuelve todos.

  • name es como lo guardaste en la libreta del teléfono; notify es el nombre que la persona puso en su WhatsApp.
  • La lista se arma con la libreta del teléfono (se sincroniza al vincular el número) y con cada persona que te escribe. Un número recién vinculado puede tardar unos minutos en tenerla completa.
Método y rutaPara qué sirveRespuesta
GET /contacts/:numeroDetalle de un contacto{"success":true,"data":{"id":"5215598765432@s.whatsapp.net","name","notify","verifiedName","imgUrl","status"}} (404 si no está en la lista)
GET /contacts/:numero/pictureFoto de perfil{"success":true,"data":{"imgUrl":"https://..."}} (null si es privada)
POST /contacts/:numero/blockBloquear{"success":true,"data":{"message":"Contact blocked"}}
POST /contacts/:numero/unblockDesbloquear{"success":true,"data":{"message":"Contact unblocked"}}

:numero acepta el número (con lada, sin +) o el jid (...@s.whatsapp.net o ...@lid, con la @ como %40).

PUT/contacts guarda un contacto con nombre en tu número (por ejemplo, para que un cliente nuevo aparezca con su nombre en lugar de solo el teléfono):

curl -X PUT https://waseller.mx/api/v1/contacts \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5219991234567","name":"Ana López"}'

Respuesta 200: {"success":true,"data":{"jid":"5219991234567@s.whatsapp.net","phone":"5219991234567","name":"Ana López"}}.

  • Es idempotente: si el contacto ya existe, solo se actualiza el nombre.
  • phone lleva de 8 a 15 dígitos (con lada, sin +) y name de 1 a 100 caracteres; si no, responde 400. Responde 404 si el número no tiene WhatsApp y 400 si tu número no está conectado.
  • El nombre se ve dentro de WhatsApp; que llegue a la libreta de contactos del teléfono depende del teléfono.

Grupos

Para escribir a un grupo usa POST /send-message con to igual al jid del grupo (120363...@g.us). En la ruta, el jid va tal cual o con la @ como %40.

Método y rutaCuerpoRespuesta
GET /groups—{"success":true,"data":[{"jid","name","imgUrl"}]}
POST /groups{"name":"Clientes VIP","participants":["5215598765432"]}{"success":true,"data":{"id","owner","subject","creation","participants":[{"id","phoneNumber","admin"}]}}
GET /groups/:jid/metadata—{"success":true,"data":{"jid","subject","creation","owner","desc","participants":[{"jid","phoneNumber","isAdmin","isSuperAdmin"}]}}
GET /groups/:jid/participants—{"success":true,"data":[{"id","phoneNumber","admin"}]}
POST /groups/:jid/participants/add{"participants":["5215598765432"]}{"success":true,"data":[{"status":200,"jid","message":"added"}]}
POST /groups/:jid/participants/remove{"participants":[...]}igual, con "removed"
PUT /groups/:jid/participants/update{"action":"promote","participants":[...]} (promote o demote){"success":true,"data":{"participants":[...]}}
PUT /groups/:jid/settings{"subject","description","announce","restrict"} (todos opcionales){"success":true,"data":{"subject","description"}}
GET /groups/:jid/invite-link—{"success":true,"inviteLink":"https://chat.whatsapp.com/..."}
GET /groups/:jid/picture—{"success":true,"data":{"imgUrl":"https://..."}}
POST /groups/:jid/leave—{"success":true,"data":{}}
  • announce: true = solo los administradores escriben; restrict: true = solo ellos cambian los datos del grupo.
  • Agregar, quitar, ascender, cambiar ajustes y pedir el enlace exigen que tu número sea administrador del grupo; si no, responde 403.
  • En participants/add, un status distinto de 200 es por persona (por ejemplo 403 si su privacidad no permite que la agreguen).

Etiquetas (WhatsApp Business)

Solo aplica a números con WhatsApp Business: son las etiquetas que el dueño pone a sus chats en el teléfono (por ejemplo "seguimiento" o "cliente nuevo"). En un WhatsApp normal no existen: GET /labels responde una lista vacía y crear o poner etiquetas no funciona.

Método y rutaCuerpoRespuesta
GET /labels—{"success":true,"data":[{"id":"3","name":"seguimiento","color":4,"deleted":false,"chats":[{"jid":"5215598765432@s.whatsapp.net","phone":"5215598765432"}]}]}
GET /labels/:id/chats—{"success":true,"data":[{"jid","phone"}]} (404 si la etiqueta no existe)
POST /labels{"name":"seguimiento","color":4} (color opcional){"success":true,"data":{"id":"6","name":"seguimiento","color":4}}
POST /labels/:id/chats{"phone":"5215598765432"}{"success":true,"data":{"labelId":"6","chat":{"jid","phone"},"labeled":true}}
DELETE /labels/:id/chats/:numero—igual, con "labeled":false
# ver las etiquetas y sus chats
curl "https://waseller.mx/api/v1/labels" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

# crear una etiqueta
curl -X POST https://waseller.mx/api/v1/labels \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"name":"seguimiento","color":4}'

# ponerla a un chat (y quitarla)
curl -X POST https://waseller.mx/api/v1/labels/6/chats \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5215598765432"}'

curl -X DELETE https://waseller.mx/api/v1/labels/6/chats/5215598765432 \
  -H "Authorization: Bearer wsn_TU_LLAVE"
  • id es un número en texto ("1", "6"...); lo asigna WhatsApp Business o, al crearla por la API, nosotros. Cualquier otro valor en la ruta responde 400.
  • color es un entero de 0 a 19 (la paleta de WhatsApp Business); sin él se usa 0. name lleva de 1 a 100 caracteres. Datos inválidos responden 400.
  • phone lleva de 8 a 15 dígitos (con lada, sin +). Responde 404 si la etiqueta no existe o si el número no tiene WhatsApp, y 400 si tu número no está conectado (GET /labels y GET /labels/:id/chats sí responden con lo último que conocemos aunque esté desconectado).
  • En chats, phone es null cuando WhatsApp identifica el chat con un id interno (@lid) que no podemos relacionar con un teléfono, y en los grupos; en ese caso usa jid. Las etiquetas de mensajes sueltos no se listan (solo llegan por el webhook).
  • Las etiquetas que el dueño ya tenía llegan solas poco después de la primera conexión con esta función: no tienes que volver a vincular. Si pasados unos minutos GET /labels sigue vacío y el número sí usa etiquetas, desvincula el WhatsApp y escanea el QR de nuevo.
  • En las versiones recientes de WhatsApp Business las etiquetas aparecen como Listas (los filtros arriba de los chats). Por eso GET /labels también devuelve las listas que trae WhatsApp, como "No leídos", "Favoritos" o "Grupos", con su predefinedId. Una etiqueta creada con POST /labels aparece en el teléfono como una lista más.
  • Las etiquetas que ya existían no se mandan por el webhook: se leen con GET /labels. Los cambios posteriores (hechos en el teléfono o por esta API) sí llegan como labels.edit y labels.association.

Chats: archivar, fijar, silenciar y leído

Hacen lo mismo que tocar el chat en el teléfono, y se ve ahí. Solo para chats individuales (no grupos). :numero lleva de 8 a 15 dígitos (con lada, sin +).

Método y rutaQué hace
POST /chats/:numero/archive · .../unarchiveArchivar / sacar del archivo
POST /chats/:numero/pin · .../unpinFijar arriba / quitar el fijado
POST /chats/:numero/mute · .../unmuteSilenciar / quitar el silencio
POST /chats/:numero/read · .../unreadMarcar como leído / como no leído

Respuesta 200 de las acciones de chat: {"success":true,"data":{"chat":{"jid":"5215598765432@s.whatsapp.net","phone":"5215598765432"},"action":"archive"}}.

# archivar un chat
curl -X POST https://waseller.mx/api/v1/chats/5215598765432/archive \
  -H "Authorization: Bearer wsn_TU_LLAVE"

# silenciar 8 horas (sin "hours" se silencia para siempre)
curl -X POST https://waseller.mx/api/v1/chats/5215598765432/mute \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"hours":8}'
  • mute acepta hours opcional: un entero de 1 a 8760 (un año). Sin hours el chat queda silenciado para siempre; unmute lo quita.
  • Archivar y marcar leído/no leído usan el último mensaje que el gateway tiene guardado de ese chat (guardamos los últimos 1000 del número); si no hay ninguno guardado, igual se aplican al chat.
  • Responden 400 si el número de la ruta es inválido, si hours viene mal, o si tu número no está conectado; 404 si el número no tiene WhatsApp o la acción no existe.

Historial de un chat bajo demanda

POST/chats/:numero/history

Le pide al teléfono mensajes anteriores de UN chat individual. Requiere que el número tenga syncHistory activo (ver "Historial al vincular"): los mensajes llegan por tu webhook como messaging-history.set, así que sin ese evento en el número no hay dónde entregarlos (responde 400).

curl -X POST https://waseller.mx/api/v1/chats/5215598765432/history \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"count":50}'

Respuesta 200: {"success":true,"data":{"requestId":"3EB0A1B2C3D4E5F6","chat":{"jid":"5215598765432@s.whatsapp.net","phone":"5215598765432"},"count":50}}. Solo confirma que la petición salió: los mensajes llegan después por el webhook.

  • El teléfono debe estar encendido y con internet. Si no responde, no llega nada y tampoco hay un error.
  • Llega como messaging-history.set con "syncType":6 (ON_DEMAND), en lotes de hasta 200 mensajes como en "Historial al vincular". El chat va en key.remoteJid de cada mensaje; isLatest no aplica aquí.
  • count: entero de 1 a 50 (por defecto 50, el máximo por petición).
  • Parte del mensaje más viejo que tenemos guardado de ese chat (guardamos los últimos 1000 del número). Para ir más atrás, repite la llamada con oldest = el mensaje más viejo que ya recibiste: {"count":50,"oldest":{"id":"3EB0A1B2C3D4E5F6","fromMe":false,"timestamp":1700000000}} (timestamp en segundos unix: el messageTimestamp del mensaje). Si no tenemos ningún mensaje de ese chat, oldest es obligatorio (404).
  • Puede llegar el mismo mensaje dos veces (el chat se pide por número y por LID); deduplica por key.id.
  • No promete todo el historial: WhatsApp decide cuánto entrega, puede ser menos de count o nada.
  • Errores: 400 si el número de la ruta, count u oldest son inválidos, si el número no tiene syncHistory o no está conectado; 404 si el contacto no tiene WhatsApp o falta oldest.

Importar el historial a waseller

El historial que entrega messaging-history.set llega por webhook y no se guarda solo. Para guardarlo en tus chats (y leerlo con GET /messages) registra el receptor de waseller como webhook del número, con syncHistory activo; verifica la firma con el webhook_secret del número y guarda cada lote:

curl -X PUT "https://waseller.mx/api/v1/numbers/ID_DEL_NUMERO/webhook" \
  -H "Authorization: Bearer wsk_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://epepiqxgfnqtudaomtfu.supabase.co/functions/v1/history-import?since=2026-01-01","syncHistory":true}'
  • ?since=AAAA-MM-DD es opcional: descarta los mensajes anteriores a esa fecha (medianoche UTC).
  • Un número tiene un solo webhook: este reemplaza el que tengas. Al terminar, quítalo con {"url":null} o vuelve a poner el tuyo.
  • Recibe todos los eventos del número pero ignora los que no son historial; los mensajes nuevos los guarda waseller por su cuenta.
  • El historial se pide bajo demanda con POST /chats/:numero/history, un chat a la vez.
  • Guarda el texto, el tipo y el pie; no guarda archivos (sin enlace). Los grupos no se importan.
  • Es idempotente: deduplica por el id del mensaje, así que repetir un lote no duplica nada.
  • Los mensajes viejos nunca mueven el orden de los chats ni el contador de no leídos.

Rechazar una llamada

POST/calls/:callId/reject

Rechaza una llamada entrante mientras suena. :callId es el data.call.id del evento call con "status":"offer".

curl -X POST https://waseller.mx/api/v1/calls/ID_DE_LA_LLAMADA/reject \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Respuesta 200: {"success":true,"data":{"callId":"ID_DE_LA_LLAMADA","rejected":true}}.

  • Solo sirve para una llamada que sonó hace menos de ~5 minutos y no ha terminado. Si ya terminó (accept, reject, timeout o terminate), pasó ese tiempo o el servicio se reinició, responde 404 "Llamada no encontrada o ya terminó".
  • :callId lleva solo letras y números (hasta 64); otra cosa es 400. También 400 si tu número no está conectado.
  • Para rechazar todas las llamadas, tu servidor llama a esta ruta cada vez que llega un call con offer; no hay una opción de configuración que lo haga solo.

Saber si un contacto está en línea o escribiendo

POST/presence/subscribe

Te suscribe a la presencia de UN contacto: desde ese momento recibes por webhook el evento presence.update cuando se pone en línea, se desconecta, escribe o graba audio. Solo llegan los contactos que suscribes, no el de todos tus chats.

curl -X POST https://waseller.mx/api/v1/presence/subscribe \
  -H "Authorization: Bearer wsn_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5215598765432"}'

Respuesta 200: {"success":true,"data":{"chat":{"jid":"5215598765432@s.whatsapp.net","phone":"5215598765432"},"subscribed":true}}.

Evento que recibes: {"chat":{"jid":"5215598765432@s.whatsapp.net","phone":"5215598765432"},"presence":"composing","lastSeen":null}

  • presence: available (en línea, o dejó de escribir), unavailable, composing (escribiendo) o recording (grabando audio).
  • lastSeen: segundos unix de su última vez en línea, solo si el contacto lo permite y WhatsApp lo manda; si no, null. Si el contacto oculta su "en línea" en su privacidad, no llega nada.
  • La suscripción dura lo que dure la conexión. Cuando el número se reconecta (evento session.status con connected) hay que volver a suscribir a cada contacto.
  • Hasta 500 ids suscritos por número (un contacto puede ocupar 2). Pasado el tope, 400.
  • Los números creados antes de esta función no tenían presence.update en su lista de eventos; se les agrega solo al suscribir al primer contacto.
  • WhatsApp solo entrega la presencia mientras TU número está en línea. Llama POST /send-presence-update con {"jid":"<cualquier contacto>","type":"available"} y al terminar con "unavailable". Mientras estés en línea tu teléfono no recibe notificaciones (igual que con WhatsApp Web abierto). Mandar composing o recording te regresa a desconectado a los 30 s: vuelve a mandar available después.
  • El chat.jid del evento puede venir como ...@lid; usa chat.phone.
  • Errores: 400 si phone es inválido (8 a 15 dígitos) o el número no está conectado; 404 si el contacto no tiene WhatsApp.

Tu número

GET/user

Respuesta 200: {"success":true,"data":{"id":"5215512345678:12@s.whatsapp.net","name":"Mi negocio","lid":"123456789@lid"}}.

Ver los últimos eventos (depurar tu webhook)

GET/webhook-events

Devuelve los últimos 100 eventos del número, el más nuevo primero, con la misma forma que llegan a tu webhook más delivered (true si el evento salió hacia tu webhook; no confirma que tu servidor lo haya recibido bien). Úsalo para ver qué llega sin montar un servidor, o para recuperar algo si tu servidor estuvo caído. Se vacía si el servicio se reinicia.

curl "https://waseller.mx/api/v1/webhook-events" \
  -H "Authorization: Bearer wsn_TU_LLAVE"

Ritmo de envío

Cada número admite 1 mensaje cada 5 segundos. Si envias más rápido recibes 429 con el campo retry_after (segundos de espera). Reintenta pasado ese tiempo.

Webhook: eventos que recibes

Si el número tiene webhook_url, enviamos un POST a tu URL por cada evento del número de la lista de abajo:

{
  "event": "messages.upsert",
  "sessionId": "0b7f3c1e-6a9a-4c1c-9a57-5d2f0e8c1a11",
  "data": { },
  "timestamp": 1792422000000
}
  • sessionId es el id del número (el mismo que devuelve POST /numbers).
EventoCuándo llegadata
messages.upsertMensaje nuevo, entrante o saliente{"messages":{"key":{"id","fromMe","remoteJid","cleanedSenderPn"},"messageBody":"Hola","message":{...},"pushName":"Ana"}}
messages.updateCambio de estado de un mensaje{"update":{"status":3},"key":{"id","remoteJid","fromMe"}} (3 entregado, 4 leído)
messages.reactionAlguien reaccionó a un mensaje[{"key":{"id","remoteJid","fromMe"},"reaction":{"text":"👍","key":{...}}}] (text vacío = quitó la reacción)
messages.deleteAlguien borró un mensaje "para todos"{"keys":[{"id","remoteJid","fromMe"}]}
poll.resultsAlguien votó en una encuesta tuya{"key":{...},"pollResult":[{"name":"Lunes","voters":["5215598765432@s.whatsapp.net"]}]} (conteo completo cada vez)
callTe llaman, o la llamada cambia{"call":{"id","from":"5215598765432@s.whatsapp.net","date","isGroup","isVideo","status":"offer"}} (offer al sonar; luego accept, reject, timeout o terminate)
contacts.upsertContactos nuevos (libreta o quien te escribe)[{"jid","name","notify","verifiedName","imgUrl","status"}]
contacts.updateCambió un contacto (nombre, foto)[{"jid", ...solo lo que cambió}] ("imgUrl":"changed" = cambió su foto; pídela con GET /contacts/:numero/picture)
groups.upsertTe agregaron a un grupo o lo creaste[{"jid","subject","creation","owner","desc","participants":[...]}]
groups.updateCambió el nombre, descripción o ajustes de un grupo[{"jid", ...solo lo que cambió}]
group-participants.updateEntró, salió, ascendió o bajó alguien en un grupo{"jid":"...@g.us","participants":["..."],"action":"add"} (add, remove, promote, demote)
labels.editSe creó, renombró, recoloreó o borró una etiqueta (solo WhatsApp Business){"id":"6","name":"seguimiento","color":4,"deleted":false} (deleted: true = la borraron; puede traer predefinedId si es una etiqueta de las que trae WhatsApp Business)
labels.associationPusieron o quitaron una etiqueta a un chat o mensaje (solo WhatsApp Business){"type":"add","labelId":"6","chat":{"jid":"5215598765432@s.whatsapp.net","phone":"5215598765432"}} (type es add o remove; phone es null si no se conoce; si es de un mensaje trae además messageId)
presence.updateUn contacto que suscribiste con POST /presence/subscribe se puso en línea, se desconectó, escribe o graba audio{"chat":{"jid","phone"},"presence":"composing","lastSeen":null} (presence: available, unavailable, composing o recording; lastSeen en segundos unix o null)
session.statusEl número se conectó o desconectó{"status":"connected"}
qrcode.updatedHay un QR nuevo para vincular{"qr":"2@..."}
usage.warningPasaste un umbral recomendado de envíover "Avisos de uso"
messaging-history.setHistorial que WhatsApp entrega al vincular (solo con syncHistory){"messages":[{...como messages.upsert, más "messageTimestamp"}],"chats":[{"jid","name","unreadCount","conversationTimestamp"}],"contacts":[...],"syncType","progress","isLatest","batch":1,"of":3}
messages.offlineMensaje que llegó mientras el número estaba desconectado, o escrito desde el celular en ese lapso (solo con offlineMessages){"messages":{...como messages.upsert, más "messageTimestamp"}}
  • WhatsApp identifica a muchos contactos con un id interno (...@lid) en lugar del teléfono. Cuando eso pasa, remoteJid trae el @lid y el teléfono viene en cleanedSenderPn (o phoneNumber en grupos). Para relacionar acuses, reacciones y borrados con tus mensajes usa key.id, no remoteJid.
  • Los mensajes que tú envías también llegan como messages.upsert con fromMe: true. Para un agente, ignóralos (si no, se contesta a sí mismo). Los que envías por la API traen además data.messages.viaApi: true; los que escribes desde el celular no.
  • Reacciones, votos y borrados también llegan como messages.upsert con el mensaje técnico (reactionMessage, pollUpdateMessage, protocolMessage); usa los eventos dedicados de arriba e ignora esos.
  • Cada petición va firmada; comprueba la firma antes de procesarla (ver abajo).
  • La URL debe ser https y pública. Responde 200 rápido (el límite de espera es de 5 segundos). Se hace un solo intento por evento; si tu servidor estuvo caído, consulta GET /webhook-events (los últimos 100) y GET /status para ponerte al día.

Historial al vincular

El evento messaging-history.set trae los chats y mensajes viejos que WhatsApp entrega cuando vinculas un número. Es opcional y viene apagado: actívalo con "syncHistory": true en POST /numbers o con PUT /numbers/:id/webhook.

  • Actívalo antes de escanear el QR. El historial solo lo entrega WhatsApp en el momento de vincular. Si el número ya está vinculado, activarlo no trae nada: tendrías que desvincular el WhatsApp y escanear el QR de nuevo. Si ya habías pedido un QR y lo activas sin escanearlo, el QR se renueva: vuelve a pedirlo.
  • Llega una sola vez por vinculación (no al reconectar). El volumen lo decide WhatsApp: puede ser mucho, poco o casi nada, y no podemos pedir un rango (para traer mensajes anteriores de un chat después, ver "Historial de un chat bajo demanda").
  • Cada evento trae hasta 200 mensajes. batch y of indican el lote dentro de ese bloque ("batch":1,"of":3); chats y contacts van solo en el lote 1 y isLatest: true solo en el último lote del último bloque. WhatsApp puede mandar varios bloques, cada uno con su propio batch/of.
  • Los lotes salen uno tras otro con ~1 segundo de pausa y con el mismo límite de 5 segundos y un solo intento por evento: si tu servidor tarda o está caído, ese lote se pierde y no se reenvía. No salen en GET /webhook-events.
  • Cada mensaje tiene la misma forma que en messages.upsert más messageTimestamp (segundos unix). Los estados (status@broadcast), las listas de difusión y los canales no se incluyen; los grupos sí.
  • No son mensajes nuevos: no los trates como entrantes ni dispares respuestas automáticas. Tampoco aparecen en el CRM de waseller ni activan bots.

Mensajes que llegaron sin conexión

Si el número se desconecta un rato, WhatsApp entrega al reconectar lo que llegó mientras tanto (de tus contactos y lo que escribiste desde el celular). Por defecto no se reenvía; actívalo con "offlineMessages": true en POST /numbers o con PUT /numbers/:id/webhook, y llega como el evento messages.offline.

  • Mismo cuerpo que messages.upsert (data.messages es un objeto con key, messageBody, message, pushName) más messageTimestamp: la hora real del mensaje en WhatsApp, en segundos unix (la timestamp del sobre es la de entrega).
  • messages.upsert no cambia. Solo mensajes: reacciones, votos y borrados siguen por sus eventos dedicados; los canales y las listas de difusión no se incluyen; los grupos solo si no los ignora el número.
  • Los mensajes que envías por la API no salen aquí (ya tienen su eco messages.upsert con viaApi: true).
  • Salen uno tras otro con ~100 ms de pausa, hasta 500 pendientes por número: lo que pase de ahí en una ráfaga se descarta y no se reenvía. Mismo límite de 5 segundos y un solo intento que en el resto de eventos.
  • Deduplica por key.id: se omiten los ids que el número ya vio (guarda los últimos 1000), pero WhatsApp puede reentregar un mensaje si la conexión cae antes de confirmarlo.
  • No son mensajes nuevos: no dispares respuestas automáticas por ellos. Tampoco aparecen en el CRM de waseller ni activan bots.

Verificar la firma

Cada petición trae dos encabezados:

  • X-Webhook-Timestamp: segundos unix de cuando la enviamos.
  • X-Webhook-Signature-256: sha256= seguido del HMAC-SHA256 en hexadecimal de <timestamp>.<cuerpo>, con el webhook_secret del número como llave.

Calcúlalo con el cuerpo crudo, tal como llegó (antes de convertirlo a JSON). Compáralo en tiempo constante y rechaza la petición si no coincide o si el timestamp tiene más de 5 minutos.

import crypto from 'node:crypto'

function firmaValida(req, rawBody, secret) {
  const ts = req.headers['x-webhook-timestamp']
  const recibida = req.headers['x-webhook-signature-256'] ?? ''
  if (!ts || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false
  const esperada = 'sha256=' + crypto.createHmac('sha256', secret).update(`${ts}.${rawBody}`).digest('hex')
  return recibida.length === esperada.length && crypto.timingSafeEqual(Buffer.from(recibida), Buffer.from(esperada))
}

El encabezado antiguo X-Webhook-Signature (el secreto tal cual) se sigue enviando por compatibilidad, pero es obsoleto y se retirará: cambia a X-Webhook-Signature-256.

Avisos de uso

Medimos los mensajes de cada número. Si pasas de los umbrales recomendados, la respuesta de send-message incluye avisos en warnings y, si el número tiene webhook_url, recibes el evento usage.warning en tu webhook. Los avisos nunca bloquean el envío: son para que cuides la salud del número en WhatsApp.

CódigoCuándo apareceUmbral recomendado
hourly_rateMás mensajes en la última hora que el umbral30 por hora
daily_volumeMás mensajes en las últimas 24 horas que el umbral200 por día
new_number_dailyNúmero con menos de 3 días de creado que pasa del umbral en 24 horas50 por día

Estos umbrales son recomendados y pueden cambiar.

Ejemplo de warnings:

"warnings": [
  { "code": "hourly_rate", "message": "Este numero envio 31 mensajes en la ultima hora; el maximo recomendado es 30. ...", "limit": 30, "actual": 31 }
]

Evento en el webhook:

{
  "event": "usage.warning",
  "sessionId": "0b7f3c1e-6a9a-4c1c-9a57-5d2f0e8c1a11",
  "data": { "code": "hourly_rate", "message": "...", "limit": 30, "actual": 31 },
  "timestamp": 1792422000000
}

Para no saturarte, enviamos como máximo un evento usage.warning por código y por número cada hora; warnings en la respuesta aparece cada vez que el umbral esté superado (si la medición tarda más de 3 segundos, esa respuesta sale sin avisos para no retrasar tu envío).

Facturación

  • Cada número creado por API cuesta $249 MXN/mes (plan starter) o $449 MXN/mes (plan pro) y se agrega a tu suscripción de waseller con cobro prorrateado inmediato.
  • Sin una suscripción activa, POST /numbers responde 402 con Active subscription required y no se crea nada. Si tu suscripción está en periodo de prueba, la prueba termina al crear el primer número.
  • Borrar un número (o su liberación automática si nunca se conectó) baja el cobro.
  • Si cancelas tu suscripción, tus números creados por API se suspenden.
  • Las cuentas aliadas sin cobro solo se miden: no se les factura.

Errores

Los errores de la API tienen siempre esta forma:

{ "success": false, "message": "Number not found" }
CódigoSignificado
400Cuerpo no es JSON válido, o un parámetro de la ruta inválido (chat, limit, before)
401Llave ausente, inválida, revocada o del tipo equivocado para la ruta
402No tienes una suscripción activa de waseller (Active subscription required) o tiene un pago pendiente (Payment past due); no se creó nada
403El número está suspendido (QR y reinicio; desconectar, borrar y rotar llave siguen disponibles), o tu número no es administrador del grupo
404La ruta no existe o el número no es de tu cuenta
409El teléfono no está disponible (Number unavailable), o la sesión del número aún no está lista
413Cuerpo mayor a 1 MB
422Datos inválidos (número de teléfono, URL de webhook, plan distinto de starter o pro)
429Demasiado rápido (espera retry_after segundos), o ya tienes 10 números pendientes
503Servicio no disponible por un momento (por ejemplo, no pudimos comprobar tu suscripción o tu cuota de pendientes); reintenta
502No pudimos completar la operación con el servicio de mensajería o el cobro (Could not process billing; el número no se crea); reintenta
500Error interno

Las rutas de mensajería devuelven además, con su mismo código HTTP, los errores propios del servicio de mensajería (por ejemplo 400 si el número aún no está conectado).

¿Cómo puedo ayudarte hoy?