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:
| Llave | Prefijo | Para qué sirve |
|---|---|---|
| Llave de cuenta | wsk_ | Administrar números: crear, listar, QR, desconectar, borrar. Rutas /numbers... |
| Llave de número | wsn_ | 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 elwebhook_secretal crear el número, y la llavewsk_cuando la generas. No podemos recuperarlas; guárdalas en un lugar seguro. - Si una llave
wsn_se filtra, rótala conPOST /numbers/:id/rotate-key(la anterior deja de funcionar al instante). - Usar una llave
wsn_en una ruta de cuenta (o al reves) responde401. - Un número con estado
suspendedresponde403en 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 ruta | Para qué sirve |
|---|---|
POST /send-message | Enviar texto, archivo, ubicación, contacto o encuesta; responder citando |
POST /send-presence-update | Mostrar "escribiendo...", etc. |
GET /on-whatsapp/:numero | Saber si un número tiene WhatsApp |
GET /status | Estado de la conexión |
GET /user | Datos de tu número |
POST /decrypt-media | Descifrar un archivo recibido |
POST /messages/read, POST /messages/react | Marcar como leído, reaccionar |
PUT /messages/:msgId, DELETE /messages/:msgId, GET /messages/:msgId/info | Editar, borrar, consultar un mensaje |
GET /contacts, GET /contacts/:numero, GET /contacts/:numero/picture | Contactos y foto de perfil |
PUT /contacts | Guardar un contacto con nombre |
POST /contacts/:numero/block, POST /contacts/:numero/unblock | Bloquear 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/history | Pedir mensajes anteriores de un chat (llegan por webhook; requiere syncHistory) |
POST /calls/:callId/reject | Rechazar una llamada entrante |
POST /presence/subscribe | Saber si un contacto está en línea o escribiendo (llega como presence.update) |
GET /webhook-events | Ver los últimos eventos (depurar tu webhook) |
GET /messages?chat=..., GET /chats | Leer 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.fileNameymimetype: 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
composingorecordingtu 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 mandarpauseddespués: el mensaje lo quita. - Errores:
400si la sesión no está conectada,422si faltajid/typeo 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: elmsgIdde un mensaje reciente del chat (uno que enviaste o recibiste con este número). El mensaje sale como respuesta citada. Si no lo encontramos responde422.mentions: lista de números (con lada, sin+) o jids a mencionar en un grupo. Escribe también@numeroen eltextcon 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:
| Campo | Forma | Notas |
|---|---|---|
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 ruta | Cuerpo | Respuesta |
|---|---|---|
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
msgIdque no guardamos (muy viejo) responde404. infodevuelve 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ámetro | Para qué sirve |
|---|---|
chat | Obligatorio. 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) |
limit | De 1 a 100 mensajes (50 por defecto) |
before | Solo 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 (nullsi no se guardó).direction:insi lo recibió tu número,outsi lo envió.type:text,image,audio,video,document,locationocontact. Los stickers salen comoimage.text: el texto o el pie del archivo;nullsi 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,deliveredoread.
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":[]}
chates el valor que pasas aGET /messages?chat=(en un grupo, el jid del grupo).namees el nombre que la persona tiene en su WhatsApp, onull.last_message.textva 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.setoPOST /chats/:numero/historyllega por webhook y no se guarda solo. - Se pagina con
before: mientrasnext_beforeno seanullhay más mensajes; pásalo comobeforeen la siguiente llamada.nullquiere decir que llegaste al principio. - En México el mismo contacto puede estar como
52...o521...: 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,limitobeforeinválidos:400. Llavewsk_: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.
namees como lo guardaste en la libreta del teléfono;notifyes 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 ruta | Para qué sirve | Respuesta |
|---|---|---|
GET /contacts/:numero | Detalle 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/picture | Foto de perfil | {"success":true,"data":{"imgUrl":"https://..."}} (null si es privada) |
POST /contacts/:numero/block | Bloquear | {"success":true,"data":{"message":"Contact blocked"}} |
POST /contacts/:numero/unblock | Desbloquear | {"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.
phonelleva de 8 a 15 dígitos (con lada, sin+) ynamede 1 a 100 caracteres; si no, responde400. Responde404si el número no tiene WhatsApp y400si 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 ruta | Cuerpo | Respuesta |
|---|---|---|
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, unstatusdistinto de200es por persona (por ejemplo403si 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 ruta | Cuerpo | Respuesta |
|---|---|---|
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"
ides un número en texto ("1","6"...); lo asigna WhatsApp Business o, al crearla por la API, nosotros. Cualquier otro valor en la ruta responde400.colores un entero de 0 a 19 (la paleta de WhatsApp Business); sin él se usa0.namelleva de 1 a 100 caracteres. Datos inválidos responden400.phonelleva de 8 a 15 dígitos (con lada, sin+). Responde404si la etiqueta no existe o si el número no tiene WhatsApp, y400si tu número no está conectado (GET /labelsyGET /labels/:id/chatssí responden con lo último que conocemos aunque esté desconectado).- En
chats,phoneesnullcuando WhatsApp identifica el chat con un id interno (@lid) que no podemos relacionar con un teléfono, y en los grupos; en ese caso usajid. 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 /labelssigue 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 /labelstambién devuelve las listas que trae WhatsApp, como "No leídos", "Favoritos" o "Grupos", con supredefinedId. Una etiqueta creada conPOST /labelsaparece 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 comolabels.editylabels.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 ruta | Qué hace |
|---|---|
POST /chats/:numero/archive · .../unarchive | Archivar / sacar del archivo |
POST /chats/:numero/pin · .../unpin | Fijar arriba / quitar el fijado |
POST /chats/:numero/mute · .../unmute | Silenciar / quitar el silencio |
POST /chats/:numero/read · .../unread | Marcar 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}'
muteaceptahoursopcional: un entero de 1 a 8760 (un año). Sinhoursel chat queda silenciado para siempre;unmutelo 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
400si el número de la ruta es inválido, sihoursviene mal, o si tu número no está conectado;404si 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.setcon"syncType":6(ON_DEMAND), en lotes de hasta 200 mensajes como en "Historial al vincular". El chat va enkey.remoteJidde cada mensaje;isLatestno 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}}(timestampen segundos unix: elmessageTimestampdel mensaje). Si no tenemos ningún mensaje de ese chat,oldestes 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
counto nada. - Errores:
400si el número de la ruta,countuoldestson inválidos, si el número no tienesyncHistoryo no está conectado;404si el contacto no tiene WhatsApp o faltaoldest.
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-DDes 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,timeoutoterminate), pasó ese tiempo o el servicio se reinició, responde404"Llamada no encontrada o ya terminó". :callIdlleva solo letras y números (hasta 64); otra cosa es400. También400si tu número no está conectado.- Para rechazar todas las llamadas, tu servidor llama a esta ruta cada vez que llega un
callconoffer; 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) orecording(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.statusconconnected) 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.updateen 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-updatecon{"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). Mandarcomposingorecordingte regresa a desconectado a los 30 s: vuelve a mandaravailabledespués. - El
chat.jiddel evento puede venir como...@lid; usachat.phone. - Errores:
400siphonees inválido (8 a 15 dígitos) o el número no está conectado;404si 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
}
sessionIdes eliddel número (el mismo que devuelvePOST /numbers).
| Evento | Cuándo llega | data |
|---|---|---|
messages.upsert | Mensaje nuevo, entrante o saliente | {"messages":{"key":{"id","fromMe","remoteJid","cleanedSenderPn"},"messageBody":"Hola","message":{...},"pushName":"Ana"}} |
messages.update | Cambio de estado de un mensaje | {"update":{"status":3},"key":{"id","remoteJid","fromMe"}} (3 entregado, 4 leído) |
messages.reaction | Alguien reaccionó a un mensaje | [{"key":{"id","remoteJid","fromMe"},"reaction":{"text":"👍","key":{...}}}] (text vacío = quitó la reacción) |
messages.delete | Alguien borró un mensaje "para todos" | {"keys":[{"id","remoteJid","fromMe"}]} |
poll.results | Alguien votó en una encuesta tuya | {"key":{...},"pollResult":[{"name":"Lunes","voters":["5215598765432@s.whatsapp.net"]}]} (conteo completo cada vez) |
call | Te 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.upsert | Contactos nuevos (libreta o quien te escribe) | [{"jid","name","notify","verifiedName","imgUrl","status"}] |
contacts.update | Cambió un contacto (nombre, foto) | [{"jid", ...solo lo que cambió}] ("imgUrl":"changed" = cambió su foto; pídela con GET /contacts/:numero/picture) |
groups.upsert | Te agregaron a un grupo o lo creaste | [{"jid","subject","creation","owner","desc","participants":[...]}] |
groups.update | Cambió el nombre, descripción o ajustes de un grupo | [{"jid", ...solo lo que cambió}] |
group-participants.update | Entró, salió, ascendió o bajó alguien en un grupo | {"jid":"...@g.us","participants":["..."],"action":"add"} (add, remove, promote, demote) |
labels.edit | Se 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.association | Pusieron 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.update | Un 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.status | El número se conectó o desconectó | {"status":"connected"} |
qrcode.updated | Hay un QR nuevo para vincular | {"qr":"2@..."} |
usage.warning | Pasaste un umbral recomendado de envío | ver "Avisos de uso" |
messaging-history.set | Historial 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.offline | Mensaje 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,remoteJidtrae el@lidy el teléfono viene encleanedSenderPn(ophoneNumberen grupos). Para relacionar acuses, reacciones y borrados con tus mensajes usakey.id, noremoteJid. - Los mensajes que tú envías también llegan como
messages.upsertconfromMe: true. Para un agente, ignóralos (si no, se contesta a sí mismo). Los que envías por la API traen ademásdata.messages.viaApi: true; los que escribes desde el celular no. - Reacciones, votos y borrados también llegan como
messages.upsertcon 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
httpsy pública. Responde200rápido (el límite de espera es de 5 segundos). Se hace un solo intento por evento; si tu servidor estuvo caído, consultaGET /webhook-events(los últimos 100) yGET /statuspara 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.
batchyofindican el lote dentro de ese bloque ("batch":1,"of":3);chatsycontactsvan solo en el lote 1 yisLatest: truesolo en el último lote del último bloque. WhatsApp puede mandar varios bloques, cada uno con su propiobatch/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.upsertmásmessageTimestamp(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.messageses un objeto conkey,messageBody,message,pushName) másmessageTimestamp: la hora real del mensaje en WhatsApp, en segundos unix (latimestampdel sobre es la de entrega). messages.upsertno 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.upsertconviaApi: 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 elwebhook_secretdel 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ódigo | Cuándo aparece | Umbral recomendado |
|---|---|---|
hourly_rate | Más mensajes en la última hora que el umbral | 30 por hora |
daily_volume | Más mensajes en las últimas 24 horas que el umbral | 200 por día |
new_number_daily | Número con menos de 3 días de creado que pasa del umbral en 24 horas | 50 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 (planpro) y se agrega a tu suscripción de waseller con cobro prorrateado inmediato. - Sin una suscripción activa,
POST /numbersresponde402conActive subscription requiredy 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ódigo | Significado |
|---|---|
400 | Cuerpo no es JSON válido, o un parámetro de la ruta inválido (chat, limit, before) |
401 | Llave ausente, inválida, revocada o del tipo equivocado para la ruta |
402 | No tienes una suscripción activa de waseller (Active subscription required) o tiene un pago pendiente (Payment past due); no se creó nada |
403 | El número está suspendido (QR y reinicio; desconectar, borrar y rotar llave siguen disponibles), o tu número no es administrador del grupo |
404 | La ruta no existe o el número no es de tu cuenta |
409 | El teléfono no está disponible (Number unavailable), o la sesión del número aún no está lista |
413 | Cuerpo mayor a 1 MB |
422 | Datos inválidos (número de teléfono, URL de webhook, plan distinto de starter o pro) |
429 | Demasiado rápido (espera retry_after segundos), o ya tienes 10 números pendientes |
503 | Servicio no disponible por un momento (por ejemplo, no pudimos comprobar tu suscripción o tu cuota de pendientes); reintenta |
502 | No 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 |
500 | Error 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).