{"openapi":"3.1.0","info":{"title":"API de StackNetic","version":"1.0.0","description":"La API de StackNetic envía mensajes de WhatsApp (texto, plantillas con datos, fotos y documentos) desde los números de un espacio y consulta su estado.\n\n- **Autenticación:** `Authorization: Bearer snw_live_…`, con una clave del espacio. La clave vive en tu servidor: la API no admite llamadas desde un navegador (sin CORS).\n- **Envíos asíncronos:** `POST /v1/messages` responde `202` con el mensaje en cola; su estado se consulta con `GET /v1/messages/{id}` o llega al momento por webhooks.\n- **Idempotencia:** manda una `Idempotency-Key` en cada `POST`.\n- **Errores:** RFC 9457 (`application/problem+json`), con un `code` estable.\n- **Ids** con tipo (`msg_…`, `num_…`, `med_…`), **fechas** en segundos epoch UTC y **teléfonos** en E.164.\n- **Webhooks:** lo que recibe tu sistema, un cuerpo por tipo de evento con su ejemplo, está en `webhooks`. Los endpoints se gestionan en `/v1/webhook-endpoints`.","contact":{"name":"StackNetic","url":"https://messaging.stack-netic.com/docs/api"}},"externalDocs":{"description":"Documentación y catálogo de errores","url":"https://messaging.stack-netic.com/docs/api"},"servers":[{"url":"https://api.stack-netic.com/v1"}],"tags":[{"name":"Mensajes","description":"Enviar mensajes y consultar su estado."},{"name":"Archivos","description":"Subir fotos y documentos para enviarlos."},{"name":"Números","description":"Los números del espacio y si pueden enviar."},{"name":"Plantillas","description":"Las plantillas de la cuenta de WhatsApp Business y los datos que piden."},{"name":"Webhooks","description":"Los endpoints que reciben, firmados y al momento, los avisos de lo que pasa en el espacio. Qué trae cada aviso está en la guía de webhooks."},{"name":"Clave","description":"La clave con que llamas: para comprobarla y ver lo que lleva enviado hoy."}],"security":[{"bearerAuth":[]}],"paths":{"/messages":{"post":{"operationId":"messages.create","summary":"Enviar un mensaje","description":"Encola un texto, una plantilla (con sus datos y, si la tiene, el archivo del encabezado), una foto o un documento. Responde 202 con el mensaje en cola: el estado llega después (consúltalo con `GET /v1/messages/{id}`). Lo que envía la API no reabre ni asigna la conversación en la bandeja, y pasa por detrás de lo que escriben las personas. Usa siempre `Idempotency-Key`: un reintento con la misma clave no envía dos veces.","tags":["Mensajes"],"security":[{"bearerAuth":[]}],"x-scopes":["messages:send"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Una clave única por operación lógica (un UUID), de 1 a 255 caracteres ASCII visibles. Vale 24 horas: un reintento con la misma clave y el mismo contenido repite la respuesta sin repetir el efecto.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]{1,255}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageRequest"},"examples":{"ejemplo_1":{"summary":"Plantilla con datos","value":{"number":"num_02y8w48sgGf2ztA7qbjqso","to":"+593991234567","type":"template","template":{"name":"recordatorio_cita","language":"es","params":{"body":{"nombre":"Ana","fecha":"martes 12 de octubre","hora":"10:00"}}},"client_reference":"cita-8841","ttl":3600}},"ejemplo_2":{"summary":"Comprobante: plantilla con un PDF en el encabezado","value":{"number":"num_02y8w48sgGf2ztA7qbjqso","to":"+593991234567","type":"template","template":{"name":"comprobante","language":"es","params":{"header_media":{"media_id":"med_02y9HHPWRS3wHysjF22iwI"},"body":{"numero":"001-002-000123","total":"$ 45,20"}}},"client_reference":"fac-001-002-000123"}},"ejemplo_3":{"summary":"Texto (con la ventana de 24 horas abierta)","value":{"number":"num_02y8w48sgGf2ztA7qbjqso","to":"+593991234567","type":"text","text":{"body":"Su pedido 8841 salió hoy. Le escribimos cuando llegue."},"client_reference":"pedido-8841"}},"ejemplo_4":{"summary":"Documento suelto","value":{"number":"num_02y8w48sgGf2ztA7qbjqso","to":"+593991234567","type":"document","document":{"media_id":"med_02y9HHPWRS3wHysjF22iwI","caption":"Su comprobante"}}}}}}},"responses":{"202":{"description":"El mensaje, en cola. `Location` apunta a él.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}},"Location":{"description":"La ruta del mensaje creado.","schema":{"type":"string"}},"Idempotent-Replayed":{"description":"`true` si la respuesta es la repetición de una petición idempotente ya hecha.","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"},"examples":{"ejemplo_1":{"summary":"Plantilla con datos","value":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"template","text":"Hola Ana, te esperamos el martes 12 de octubre a las 10:00.","template":{"name":"recordatorio_cita","language":"es"},"media":null,"status":"queued","error":null,"client_reference":"cita-8841","sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción"},"whatsapp_id":null,"created_at":1790546400,"status_updated_at":1790546400,"expires_at":1790550000,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}},"ejemplo_2":{"summary":"Comprobante: plantilla con un PDF en el encabezado","value":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"template","text":"Hola, adjuntamos su comprobante 001-002-000123 por $ 45,20. Gracias por su compra.","template":{"name":"comprobante","language":"es"},"media":{"id":"med_02y9HHPWRS3wHysjF22iwI","kind":"document","content_type":"application/pdf","filename":"RIDE-001-002-000123.pdf","caption":null,"size_bytes":48213},"status":"queued","error":null,"client_reference":"fac-001-002-000123","sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción"},"whatsapp_id":null,"created_at":1790546400,"status_updated_at":1790546400,"expires_at":1790632800,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}},"ejemplo_3":{"summary":"Texto (con la ventana de 24 horas abierta)","value":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"text","text":"Su pedido 8841 salió hoy. Le escribimos cuando llegue.","template":null,"media":null,"status":"queued","error":null,"client_reference":"pedido-8841","sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción"},"whatsapp_id":null,"created_at":1790546400,"status_updated_at":1790546400,"expires_at":1790632800,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}},"ejemplo_4":{"summary":"Documento suelto","value":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"document","text":"Su comprobante","template":null,"media":{"id":"med_02y9HHPWRS3wHysjF22iwI","kind":"document","content_type":"application/pdf","filename":"RIDE-001-002-000123.pdf","caption":"Su comprobante","size_bytes":48213},"status":"queued","error":null,"client_reference":null,"sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción"},"whatsapp_id":null,"created_at":1790546400,"status_updated_at":1790546400,"expires_at":1790632800,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}}}}}},"400":{"description":"`BAD_REQUEST`: La petición está mal formada.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`TEMPLATE_CATEGORY_NOT_ALLOWED`: La clave no puede enviar esa categoría. `READ_ONLY`: El espacio está en solo lectura. `FORBIDDEN`: No se puede hacer. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`UPLOAD_USED`: El archivo ya se usó. `CONFLICT`: Conflicto.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"`UPLOAD_EXPIRED`: El archivo caducó.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"`PAYLOAD_TOO_LARGE`: Demasiado grande.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"`UNSUPPORTED_MEDIA_TYPE`: Tipo no admitido.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`VALIDATION_FAILED`: Los datos no son válidos. `TEMPLATE_NOT_FOUND`: La plantilla no existe. `TEMPLATE_NOT_SENDABLE`: La plantilla no se puede enviar. `IDEMPOTENCY_KEY_REUSED`: Esa clave de idempotencia ya se usó con otra petición.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`DAILY_LIMIT_REACHED`: La clave llegó a su tope diario. `QUEUE_FULL`: Hay demasiados mensajes esperando. `RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"`META_ERROR`: WhatsApp no respondió como se esperaba.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"`NOT_CONFIGURED`: El número no puede enviar ahora.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"operationId":"messages.list","summary":"Listar mensajes","description":"Del más reciente al más antiguo, con cursor. Con `messages:send`, solo los que envió esta clave. Sirve para consultar, no para sincronizar sin huecos: para no perder nada, consulta desde `since` = la última marca vista menos 5 minutos y descarta los ids ya vistos (los avisos automáticos llegarán con los webhooks).","tags":["Mensajes"],"security":[{"bearerAuth":[]}],"x-scopes":["messages:read","messages:send"],"parameters":[{"name":"number","in":"query","required":false,"description":"Solo los de este número.","schema":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]}},{"name":"contact","in":"query","required":false,"description":"Solo los de este contacto: su teléfono o su BSUID.","schema":{"type":"string","minLength":3,"maxLength":80}},{"name":"direction","in":"query","required":false,"schema":{"type":"string","enum":["inbound","outbound"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["queued","sending","accepted","sent","delivered","read","failed","received"]}},{"name":"client_reference","in":"query","required":false,"description":"Solo los que llevan esta referencia (exacta).","schema":{"type":"string","minLength":1,"maxLength":128}},{"name":"api_key","in":"query","required":false,"description":"Solo los que envió esta clave. Con `messages:read`.","schema":{"type":"string","pattern":"^key_[0-9A-Za-z]{22}$","examples":["key_02y9HfsYGgsLoqUuhdpNYk"]}},{"name":"since","in":"query","required":false,"description":"Desde este momento (epoch), incluido.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"until","in":"query","required":false,"description":"Hasta este momento (epoch), incluido.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"limit","in":"query","required":false,"description":"Cuántos por página: de 1 a 100.","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"El `next_cursor` de la página anterior.","schema":{"type":"string","minLength":1,"maxLength":512}}],"responses":{"200":{"description":"Una página de mensajes.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageList"},"examples":{"ejemplo_1":{"summary":"Por referencia","value":{"object":"list","data":[{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"template","text":"Hola, adjuntamos su comprobante 001-002-000123 por $ 45,20. Gracias por su compra.","template":{"name":"comprobante","language":"es"},"media":{"id":"med_02y9HHPWRS3wHysjF22iwI","kind":"document","content_type":"application/pdf","filename":"RIDE-001-002-000123.pdf","caption":null,"size_bytes":48213},"status":"queued","error":null,"client_reference":"lote-7","sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción"},"whatsapp_id":null,"created_at":1790546400,"status_updated_at":1790546400,"expires_at":1790632800,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}],"has_more":true,"next_cursor":"v1.QmFzZTY0VXJsQ2lmcmFkbw"}}}}}},"400":{"description":"`INVALID_CURSOR`: El cursor no es válido.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`VALIDATION_FAILED`: Los datos no son válidos.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/messages/{id}":{"get":{"operationId":"messages.get","summary":"Leer un mensaje","description":"El mensaje y su estado actual. Con `messages:send`, solo los que envió esta clave; con `messages:read`, todos los de sus números, también los que llegan.","tags":["Mensajes"],"security":[{"bearerAuth":[]}],"x-scopes":["messages:read","messages:send"],"parameters":[{"name":"id","in":"path","required":true,"description":"El id del mensaje (`msg_…`).","schema":{"type":"string","pattern":"^msg_[0-9A-Za-z]{22}$","examples":["msg_02y9HflgNTRjaQMubfP6vm"]}}],"responses":{"200":{"description":"El mensaje.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"},"examples":{"ejemplo_1":{"summary":"Entregado","value":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"template","text":"Hola, adjuntamos su comprobante 001-002-000123 por $ 45,20. Gracias por su compra.","template":{"name":"comprobante","language":"es"},"media":{"id":"med_02y9HHPWRS3wHysjF22iwI","kind":"document","content_type":"application/pdf","filename":"RIDE-001-002-000123.pdf","caption":null,"size_bytes":48213},"status":"delivered","error":null,"client_reference":"fac-001-002-000123","sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción"},"whatsapp_id":"wamid.HBgMNTkzOTkxMjM0NTY3FQIAERgSMUQ3RjBBMkI2QjZBQTlGNjNBAA==","created_at":1790546400,"status_updated_at":1790546412,"expires_at":null,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}},"ejemplo_2":{"summary":"Fallido","value":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"template","text":"Hola, adjuntamos su comprobante 001-002-000123 por $ 45,20. Gracias por su compra.","template":{"name":"comprobante","language":"es"},"media":{"id":"med_02y9HHPWRS3wHysjF22iwI","kind":"document","content_type":"application/pdf","filename":"RIDE-001-002-000123.pdf","caption":null,"size_bytes":48213},"status":"failed","error":{"code":"window_closed","message":"Han pasado más de 24 h desde su último mensaje: usa una plantilla.","meta_code":131047},"client_reference":"fac-001-002-000123","sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción"},"whatsapp_id":null,"created_at":1790546400,"status_updated_at":1790546400,"expires_at":null,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/messages/{id}/media":{"get":{"operationId":"messages.media","summary":"Descargar el archivo de un mensaje","description":"La foto, el audio, el vídeo, el documento o el sticker de un mensaje, con sus bytes tal cual (`Content-Type` dice su formato y `Content-Disposition`, su nombre). Lo que llega se guarda al momento, y WhatsApp lo conserva solo 7 días: mientras se guarda responde `409 MEDIA_NOT_READY` con `Retry-After`, y si ya no estaba, `410 MEDIA_UNAVAILABLE`. Admite `Range` para bajarlo por partes (206). Ve los mismos mensajes que «Leer un mensaje».","tags":["Mensajes"],"security":[{"bearerAuth":[]}],"x-scopes":["messages:read","messages:send"],"parameters":[{"name":"id","in":"path","required":true,"description":"El id del mensaje (`msg_…`).","schema":{"type":"string","pattern":"^msg_[0-9A-Za-z]{22}$","examples":["msg_02y9HflgNTRjaQMubfP6vm"]}}],"responses":{"200":{"description":"El archivo entero.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}},"Content-Type":{"description":"El formato del archivo (`image/jpeg`, `application/pdf`…).","schema":{"type":"string"}},"Content-Length":{"description":"Los bytes de esta respuesta.","schema":{"type":"integer"}},"Content-Disposition":{"description":"`attachment`, con el nombre del archivo (el original, si lo trae).","schema":{"type":"string"}},"Accept-Ranges":{"description":"`bytes`: se puede pedir por partes con `Range`.","schema":{"type":"string"}},"ETag":{"description":"La huella SHA-256 del archivo entero.","schema":{"type":"string"}}},"content":{"*/*":{"schema":{"type":"string","contentMediaType":"application/octet-stream"}}}},"206":{"description":"El rango pedido con `Range`, con `Content-Range`.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}},"Content-Type":{"description":"El formato del archivo (`image/jpeg`, `application/pdf`…).","schema":{"type":"string"}},"Content-Length":{"description":"Los bytes de esta respuesta.","schema":{"type":"integer"}},"Content-Disposition":{"description":"`attachment`, con el nombre del archivo (el original, si lo trae).","schema":{"type":"string"}},"Accept-Ranges":{"description":"`bytes`: se puede pedir por partes con `Range`.","schema":{"type":"string"}},"ETag":{"description":"La huella SHA-256 del archivo entero.","schema":{"type":"string"}},"Content-Range":{"description":"Con 206: el trozo que va y el tamaño entero (`bytes 0-1023/48213`).","schema":{"type":"string"}}},"content":{"*/*":{"schema":{"type":"string","contentMediaType":"application/octet-stream"}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`MEDIA_NOT_READY`: El archivo todavía no está listo.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"`MEDIA_UNAVAILABLE`: El archivo ya no está disponible.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"416":{"description":"`RANGE_NOT_SATISFIABLE`: El rango pedido no está en el archivo.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Content-Range":{"description":"El tamaño del archivo: `bytes */48213`.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/messages/{id}/read":{"post":{"operationId":"messages.read","summary":"Marcar como leído","description":"Le dice a WhatsApp que el negocio leyó un mensaje que llegó: el contacto ve los dos ticks azules. Responde 202 en cuanto queda en cola y sale en segundos, en el turno de su número. Repetirlo no manda otro aviso. Pide los dos permisos, leer y enviar mensajes; uno enviado responde `422 MESSAGE_NOT_INBOUND`.","tags":["Mensajes"],"security":[{"bearerAuth":[]}],"x-scopes":["messages:read","messages:send"],"x-scopes-match":"all","parameters":[{"name":"id","in":"path","required":true,"description":"El id del mensaje (`msg_…`).","schema":{"type":"string","pattern":"^msg_[0-9A-Za-z]{22}$","examples":["msg_02y9HflgNTRjaQMubfP6vm"]}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Una clave única por operación lógica (un UUID), de 1 a 255 caracteres ASCII visibles. Vale 24 horas: un reintento con la misma clave y el mismo contenido repite la respuesta sin repetir el efecto.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]{1,255}$"}}],"responses":{"202":{"description":"El aviso de leído, en cola.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadReceipt"},"examples":{"ejemplo_1":{"summary":"Marcar la respuesta de un contacto","value":{"object":"read_receipt","message":"msg_02y9HflgNTRjaQMubfP6vm","status":"queued"}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`MESSAGE_NOT_INBOUND`: Ese mensaje no llegó de un contacto.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"`NOT_CONFIGURED`: El número no puede enviar ahora.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/media":{"post":{"operationId":"media.create","summary":"Subir un archivo","description":"Sube una foto (JPG o PNG, hasta 5 MB) o un documento (PDF, Word, Excel, PowerPoint o texto, hasta 16 MB) para enviarlo en un mensaje: suelto (`purpose=message`) o en el encabezado de una plantilla (`purpose=header` con `kind`). Se usa una sola vez y dura 24 horas. Solo lo puede usar la clave que lo subió.","tags":["Archivos"],"security":[{"bearerAuth":[]}],"x-scopes":["messages:send"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Una clave única por operación lógica (un UUID), de 1 a 255 caracteres ASCII visibles. Vale 24 horas: un reintento con la misma clave y el mismo contenido repite la respuesta sin repetir el efecto.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]{1,255}$"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","description":"`multipart/form-data` con los campos y el archivo en la parte `file`.","properties":{"number":{"description":"El número desde el que se enviará.","type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"purpose":{"default":"message","description":"`message`: una foto o un documento suelto. `header`: el encabezado de una plantilla.","type":"string","enum":["message","header"]},"kind":{"description":"Con `purpose=header`: el tipo del encabezado.","type":"string","enum":["image","document"]},"file":{"type":"string","contentMediaType":"application/octet-stream","description":"El archivo."}},"required":["number","file"]}}}},"responses":{"201":{"description":"El archivo, listo para enviarlo.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}},"Idempotent-Replayed":{"description":"`true` si la respuesta es la repetición de una petición idempotente ya hecha.","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Media"},"examples":{"ejemplo_1":{"summary":"El PDF del encabezado de un comprobante","value":{"object":"media","id":"med_02y9HHPWRS3wHysjF22iwI","kind":"document","content_type":"application/pdf","filename":"RIDE-001-002-000123.pdf","size_bytes":48213,"renamed":false,"expires_at":1790632800}}}}}},"400":{"description":"`BAD_REQUEST`: La petición está mal formada.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`IDEMPOTENCY_IN_PROGRESS`: Esa petición se está procesando.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"411":{"description":"`LENGTH_REQUIRED`: Falta el tamaño.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"`PAYLOAD_TOO_LARGE`: Demasiado grande.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"`UNSUPPORTED_MEDIA_TYPE`: Tipo no admitido.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`VALIDATION_FAILED`: Los datos no son válidos. `MEDIA_REJECTED`: WhatsApp no aceptó el archivo. `IDEMPOTENCY_KEY_REUSED`: Esa clave de idempotencia ya se usó con otra petición.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"`META_ERROR`: WhatsApp no respondió como se esperaba.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"`BUSY`: El servidor está ocupado con otros archivos. `STORAGE_UNAVAILABLE`: No se pudo guardar el archivo. `NOT_CONFIGURED`: El número no puede enviar ahora.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/numbers":{"get":{"operationId":"numbers.list","summary":"Listar los números","description":"Los números que alcanza la clave, con su estado, su calidad, si pueden enviar y por qué no.","tags":["Números"],"security":[{"bearerAuth":[]}],"x-scopes":["numbers:read"],"responses":{"200":{"description":"Los números.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberList"},"examples":{"ejemplo_1":{"summary":"Un número de una cuenta sin método de pago","value":{"object":"list","data":[{"object":"number","id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312","display_name":"StackNetic","label":"Ventas","mode":"coexistence","status":"active","quality":"green","messaging_limit":"TIER_1K","can_send":"blocked","issues":[{"code":141006,"title":"Falta un método de pago en la cuenta de WhatsApp Business","solution":"Meta no deja iniciar conversaciones hasta que se añada un método de pago válido en WhatsApp Manager → Configuración de pagos."}],"whatsapp_account":{"id":"wa_02y8w2MyKl4wS3UC9VNwwo","name":"StackNetic operations","can_send":"blocked"},"connected_at":1790200000}],"has_more":false,"next_cursor":null}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/numbers/{id}":{"get":{"operationId":"numbers.get","summary":"Leer un número","description":"Un número: su estado, si puede enviar y su cuenta de WhatsApp Business.","tags":["Números"],"security":[{"bearerAuth":[]}],"x-scopes":["numbers:read"],"parameters":[{"name":"id","in":"path","required":true,"description":"El id del número (`num_…`).","schema":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]}}],"responses":{"200":{"description":"El número.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Number"},"examples":{"ejemplo_1":{"summary":"Bloqueado por el pago de la cuenta","value":{"object":"number","id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312","display_name":"StackNetic","label":"Ventas","mode":"coexistence","status":"active","quality":"green","messaging_limit":"TIER_1K","can_send":"blocked","issues":[{"code":141006,"title":"Falta un método de pago en la cuenta de WhatsApp Business","solution":"Meta no deja iniciar conversaciones hasta que se añada un método de pago válido en WhatsApp Manager → Configuración de pagos."}],"whatsapp_account":{"id":"wa_02y8w2MyKl4wS3UC9VNwwo","name":"StackNetic operations","can_send":"blocked"},"connected_at":1790200000}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/templates":{"get":{"operationId":"templates.list","summary":"Listar las plantillas","description":"Las plantillas de la cuenta de WhatsApp Business del número, con los datos que pide cada una (y su ruta en la petición) y si se puede enviar por la API.","tags":["Plantillas"],"security":[{"bearerAuth":[]}],"x-scopes":["templates:read"],"parameters":[{"name":"number","in":"query","required":true,"description":"El número: sus plantillas son las de su cuenta de WhatsApp Business.","schema":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]}}],"responses":{"200":{"description":"Las plantillas.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateList"},"examples":{"ejemplo_1":{"summary":"Una plantilla con un PDF en el encabezado","value":{"object":"list","data":[{"object":"template","name":"comprobante","language":"es","category":"UTILITY","status":"APPROVED","whatsapp_account":"wa_02y8w2MyKl4wS3UC9VNwwo","sendable":true,"not_sendable_reason":null,"fields":[{"path":"template.params.header_media.media_id","type":"media","media_kind":"document","label":"Documento del encabezado","required":true,"example":null,"max_length":null},{"path":"template.params.body.numero","type":"text","media_kind":null,"label":"Numero","required":true,"example":"001-002-000123","max_length":1024},{"path":"template.params.body.total","type":"text","media_kind":null,"label":"Total","required":true,"example":"$ 45,20","max_length":1024}],"preview":{"header":"[Documento]","body":"Hola, adjuntamos su comprobante {{numero}} por {{total}}. Gracias por su compra.","footer":null,"buttons":[]}}],"has_more":false,"next_cursor":null}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`VALIDATION_FAILED`: Los datos no son válidos.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"`META_ERROR`: WhatsApp no respondió como se esperaba.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"`NOT_CONFIGURED`: El número no puede enviar ahora.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"operationId":"templates.create","summary":"Crear una plantilla","description":"Crea una plantilla en la cuenta de WhatsApp Business del número y la envía a revisión: queda `PENDING` hasta que WhatsApp la apruebe. En JSON, o en `multipart/form-data` con el borrador en la parte `draft` y la muestra del encabezado (imagen o documento) en `sample`.","tags":["Plantillas"],"security":[{"bearerAuth":[]}],"x-scopes":["templates:write"],"x-capability":"templates","parameters":[{"name":"number","in":"query","required":true,"description":"El número: sus plantillas son las de su cuenta de WhatsApp Business.","schema":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Una clave única por operación lógica (un UUID), de 1 a 255 caracteres ASCII visibles. Vale 24 horas: un reintento con la misma clave y el mismo contenido repite la respuesta sin repetir el efecto.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]{1,255}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTemplateRequest"},"examples":{"ejemplo_1":{"summary":"Un recordatorio con variables","value":{"name":"recordatorio_cita","language":"es","category":"UTILITY","body":"Hola {{nombre}}, te esperamos el {{fecha}}.","examples":{"nombre":"Ana","fecha":"martes 12 de octubre"}}}}},"multipart/form-data":{"schema":{"type":"object","description":"La parte `draft` lleva el borrador en JSON y `sample`, la muestra.","properties":{"draft":{"type":"string","minLength":2,"maxLength":65536,"description":"El borrador, en JSON (como el cuerpo JSON del alta)."},"sample":{"type":"string","contentMediaType":"application/octet-stream","description":"La muestra del encabezado: una foto o un PDF."}},"required":["draft"]}}}},"responses":{"201":{"description":"La plantilla, en revisión.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}},"Idempotent-Replayed":{"description":"`true` si la respuesta es la repetición de una petición idempotente ya hecha.","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Template"},"examples":{"ejemplo_1":{"summary":"Un recordatorio con variables","value":{"object":"template","name":"recordatorio_cita","language":"es","category":"UTILITY","status":"PENDING","whatsapp_account":"wa_02y8w2MyKl4wS3UC9VNwwo","sendable":false,"not_sendable_reason":{"code":"not_approved","message":"En revisión: WhatsApp todavía no la aprobó."},"fields":[{"path":"template.params.body.nombre","type":"text","media_kind":null,"label":"Nombre","required":true,"example":"Ana","max_length":1024},{"path":"template.params.body.fecha","type":"text","media_kind":null,"label":"Fecha","required":true,"example":"martes 12 de octubre","max_length":1024}],"preview":{"header":null,"body":"Hola {{nombre}}, te esperamos el {{fecha}}.","footer":null,"buttons":[]}}}}}}},"400":{"description":"`BAD_REQUEST`: La petición está mal formada.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`IDEMPOTENCY_IN_PROGRESS`: Esa petición se está procesando.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"`PAYLOAD_TOO_LARGE`: Demasiado grande.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"`UNSUPPORTED_MEDIA_TYPE`: Tipo no admitido.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`VALIDATION_FAILED`: Los datos no son válidos. `IDEMPOTENCY_KEY_REUSED`: Esa clave de idempotencia ya se usó con otra petición. `MEDIA_REJECTED`: WhatsApp no aceptó el archivo.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"`META_ERROR`: WhatsApp no respondió como se esperaba.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"`NOT_CONFIGURED`: El número no puede enviar ahora. `BUSY`: El servidor está ocupado con otros archivos.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/templates/{name}":{"delete":{"operationId":"templates.delete","summary":"Borrar una plantilla","description":"Borra de la cuenta de WhatsApp Business, en todos sus idiomas, una plantilla creada desde este espacio. Las demás se gestionan en WhatsApp Manager.","tags":["Plantillas"],"security":[{"bearerAuth":[]}],"x-scopes":["templates:write"],"x-capability":"templates","parameters":[{"name":"name","in":"path","required":true,"description":"El nombre de la plantilla.","schema":{"type":"string","pattern":"^[a-z0-9_]{1,512}$"}},{"name":"number","in":"query","required":true,"description":"El número: sus plantillas son las de su cuenta de WhatsApp Business.","schema":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]}}],"responses":{"200":{"description":"Borrada.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedTemplate"},"examples":{"ejemplo_1":{"summary":"Borrar","value":{"object":"template","name":"recordatorio_cita","deleted":true}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FORBIDDEN`: No se puede hacer. `READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"`META_ERROR`: WhatsApp no respondió como se esperaba.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"`NOT_CONFIGURED`: El número no puede enviar ahora.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/webhook-endpoints":{"get":{"operationId":"webhook_endpoints.list","summary":"Listar los endpoints","description":"Los endpoints que creó esta clave —o las que reemplazó al rotarla—, del más reciente al más antiguo, con su estado y su salud. Los creados en la consola no aparecen aquí.","tags":["Webhooks"],"security":[{"bearerAuth":[]}],"x-scopes":["webhooks:write"],"x-capability":"webhooks","responses":{"200":{"description":"Los endpoints.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointList"},"examples":{"ejemplo_1":{"summary":"Un endpoint","value":{"object":"list","data":[{"object":"webhook_endpoint","id":"we_02y8w4hE8Lo89zo8KTrC1e","url":"https://api.tuempresa.com/webhooks/stacknetic","description":"Facturador: el estado de los comprobantes","events":["message.status","number.status"],"numbers":["num_02y8w48sgGf2ztA7qbjqso"],"api_version":"v1","status":"active","status_reason":null,"secret":null,"secret_hint":"LaSw","health":{"failing":false,"consecutive_failures":0,"failing_since":null,"last_attempt_at":1790546412,"last_success_at":1790546412,"last_failure_at":null,"last_failure_code":null},"created_at":1790460000,"updated_at":1790460000}],"has_more":false,"next_cursor":null}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"operationId":"webhook_endpoints.create","summary":"Crear un endpoint","description":"Da de alta una URL de tu sistema para recibir, firmados y al momento, los eventos que elijas de los números que elijas. Se comprueban la URL y su DNS. La respuesta trae el secreto con que se firman (`secret`, `whsec_…`) **solo esta vez**: guárdalo para verificar la firma, como explica la guía de webhooks. Usa `Idempotency-Key`: un reintento no crea otro endpoint, y su respuesta trae `secret: null`.","tags":["Webhooks"],"security":[{"bearerAuth":[]}],"x-scopes":["webhooks:write"],"x-capability":"webhooks","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Una clave única por operación lógica (un UUID), de 1 a 255 caracteres ASCII visibles. Vale 24 horas: un reintento con la misma clave y el mismo contenido repite la respuesta sin repetir el efecto.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]{1,255}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookEndpointRequest"},"examples":{"ejemplo_1":{"summary":"Los estados de los mensajes y de un número","value":{"url":"https://api.tuempresa.com/webhooks/stacknetic","description":"Facturador: el estado de los comprobantes","events":["message.status","number.status"],"numbers":["num_02y8w48sgGf2ztA7qbjqso"]}}}}}},"responses":{"201":{"description":"El endpoint, activo, con su secreto.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}},"Idempotent-Replayed":{"description":"`true` si la respuesta es la repetición de una petición idempotente ya hecha.","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"},"examples":{"ejemplo_1":{"summary":"Los estados de los mensajes y de un número","value":{"object":"webhook_endpoint","id":"we_02y8w4hE8Lo89zo8KTrC1e","url":"https://api.tuempresa.com/webhooks/stacknetic","description":"Facturador: el estado de los comprobantes","events":["message.status","number.status"],"numbers":["num_02y8w48sgGf2ztA7qbjqso"],"api_version":"v1","status":"active","status_reason":null,"secret":"whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw","secret_hint":"LaSw","health":{"failing":false,"consecutive_failures":0,"failing_since":null,"last_attempt_at":null,"last_success_at":null,"last_failure_at":null,"last_failure_code":null},"created_at":1790546400,"updated_at":1790546400}}}}}},"400":{"description":"`BAD_REQUEST`: La petición está mal formada.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`WEBHOOK_EVENTS_NOT_ALLOWED`: La clave no puede recibir esos eventos. `WEBHOOK_CHANNELS_NOT_ALLOWED`: Incluye números que la clave no alcanza. `READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`WEBHOOK_LIMIT_REACHED`: El espacio llegó a su máximo de endpoints. `IDEMPOTENCY_IN_PROGRESS`: Esa petición se está procesando.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"`PAYLOAD_TOO_LARGE`: Demasiado grande.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"`UNSUPPORTED_MEDIA_TYPE`: Tipo no admitido.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`VALIDATION_FAILED`: Los datos no son válidos. `WEBHOOK_URL_INVALID`: La URL no sirve para un webhook. `WEBHOOK_URL_UNRESOLVABLE`: No encontramos ese dominio. `WEBHOOK_URL_NOT_ALLOWED`: Esa dirección no está permitida. `WEBHOOK_EVENT_UNKNOWN`: Ese evento no existe. `IDEMPOTENCY_KEY_REUSED`: Esa clave de idempotencia ya se usó con otra petición.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/webhook-endpoints/{id}":{"get":{"operationId":"webhook_endpoints.get","summary":"Leer un endpoint","description":"Un endpoint que creó esta clave, con su estado y su salud. Uno de la consola o de otra clave no existe para ella (404).","tags":["Webhooks"],"security":[{"bearerAuth":[]}],"x-scopes":["webhooks:write"],"x-capability":"webhooks","parameters":[{"name":"id","in":"path","required":true,"description":"El id del endpoint de webhooks (`we_…`).","schema":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]}}],"responses":{"200":{"description":"El endpoint.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"},"examples":{"ejemplo_1":{"summary":"Activo y sano","value":{"object":"webhook_endpoint","id":"we_02y8w4hE8Lo89zo8KTrC1e","url":"https://api.tuempresa.com/webhooks/stacknetic","description":"Facturador: el estado de los comprobantes","events":["message.status","number.status"],"numbers":["num_02y8w48sgGf2ztA7qbjqso"],"api_version":"v1","status":"active","status_reason":null,"secret":null,"secret_hint":"LaSw","health":{"failing":false,"consecutive_failures":0,"failing_since":null,"last_attempt_at":1790546412,"last_success_at":1790546412,"last_failure_at":null,"last_failure_code":null},"created_at":1790460000,"updated_at":1790460000}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"operationId":"webhook_endpoints.update","summary":"Editar un endpoint","description":"Cambia la URL, la descripción, los eventos o los números; lo que no va se queda como estaba, y repetirla no cambia nada. Uno suspendido no se edita: hay que reactivarlo en la consola.","tags":["Webhooks"],"security":[{"bearerAuth":[]}],"x-scopes":["webhooks:write"],"x-capability":"webhooks","parameters":[{"name":"id","in":"path","required":true,"description":"El id del endpoint de webhooks (`we_…`).","schema":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookEndpointRequest"},"examples":{"ejemplo_1":{"summary":"Recibir también los mensajes que llegan","value":{"events":["message.received","message.status","number.status"]}}}}}},"responses":{"200":{"description":"El endpoint, con el cambio.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"},"examples":{"ejemplo_1":{"summary":"Recibir también los mensajes que llegan","value":{"object":"webhook_endpoint","id":"we_02y8w4hE8Lo89zo8KTrC1e","url":"https://api.tuempresa.com/webhooks/stacknetic","description":"Facturador: el estado de los comprobantes","events":["message.received","message.status","number.status"],"numbers":["num_02y8w48sgGf2ztA7qbjqso"],"api_version":"v1","status":"active","status_reason":null,"secret":null,"secret_hint":"LaSw","health":{"failing":false,"consecutive_failures":0,"failing_since":null,"last_attempt_at":1790546412,"last_success_at":1790546412,"last_failure_at":null,"last_failure_code":null},"created_at":1790460000,"updated_at":1790547000}}}}}},"400":{"description":"`BAD_REQUEST`: La petición está mal formada.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`WEBHOOK_EVENTS_NOT_ALLOWED`: La clave no puede recibir esos eventos. `WEBHOOK_CHANNELS_NOT_ALLOWED`: Incluye números que la clave no alcanza. `READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`WEBHOOK_STATE_CONFLICT`: El endpoint no admite eso en su estado.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"`PAYLOAD_TOO_LARGE`: Demasiado grande.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"`UNSUPPORTED_MEDIA_TYPE`: Tipo no admitido.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`VALIDATION_FAILED`: Los datos no son válidos. `WEBHOOK_URL_INVALID`: La URL no sirve para un webhook. `WEBHOOK_URL_UNRESOLVABLE`: No encontramos ese dominio. `WEBHOOK_URL_NOT_ALLOWED`: Esa dirección no está permitida. `WEBHOOK_EVENT_UNKNOWN`: Ese evento no existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"operationId":"webhook_endpoints.delete","summary":"Eliminar un endpoint","description":"Lo elimina y cancela lo que tenía pendiente: deja de recibir avisos al momento. No se puede deshacer.","tags":["Webhooks"],"security":[{"bearerAuth":[]}],"x-scopes":["webhooks:write"],"x-capability":"webhooks","parameters":[{"name":"id","in":"path","required":true,"description":"El id del endpoint de webhooks (`we_…`).","schema":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]}}],"responses":{"200":{"description":"Eliminado.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedWebhookEndpoint"},"examples":{"ejemplo_1":{"summary":"Eliminar","value":{"object":"webhook_endpoint","id":"we_02y8w4hE8Lo89zo8KTrC1e","deleted":true}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/webhook-endpoints/{id}/test":{"post":{"operationId":"webhook_endpoints.test","summary":"Enviar una prueba","description":"Manda al endpoint un aviso `webhook.test`, firmado como los demás y con un solo intento: sirve para probar tu receptor después de cada cambio. Responde 202 con el id del aviso, el `webhook-id` que recibirás; lo que respondió tu servidor se ve en la consola. Uno pausado o desactivado también se prueba; uno suspendido, no.","tags":["Webhooks"],"security":[{"bearerAuth":[]}],"x-scopes":["webhooks:write"],"x-capability":"webhooks","parameters":[{"name":"id","in":"path","required":true,"description":"El id del endpoint de webhooks (`we_…`).","schema":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Una clave única por operación lógica (un UUID), de 1 a 255 caracteres ASCII visibles. Vale 24 horas: un reintento con la misma clave y el mismo contenido repite la respuesta sin repetir el efecto.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[!-~]{1,255}$"}}],"responses":{"202":{"description":"La prueba, en cola.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}},"Idempotent-Replayed":{"description":"`true` si la respuesta es la repetición de una petición idempotente ya hecha.","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTest"},"examples":{"ejemplo_1":{"summary":"Probar el receptor","value":{"object":"webhook_test","id":"evt_02y9Hg6I37jaHgkutafuog","endpoint":"we_02y8w4hE8Lo89zo8KTrC1e","type":"webhook.test","created_at":1790550000}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`READ_ONLY`: El espacio está en solo lectura. `FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"`NOT_FOUND`: No existe.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"`WEBHOOK_STATE_CONFLICT`: El endpoint no admite eso en su estado. `IDEMPOTENCY_IN_PROGRESS`: Esa petición se está procesando.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"`IDEMPOTENCY_KEY_REUSED`: Esa clave de idempotencia ya se usó con otra petición.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/key":{"get":{"operationId":"key.get","summary":"Ver la clave","description":"La clave con que llamas: su nombre, sus permisos, sus números, sus envíos de hoy frente a su tope y su espacio. Vale con cualquier permiso, así que sirve para comprobar que una clave funciona. Nunca devuelve el secreto.","tags":["Clave"],"security":[{"bearerAuth":[]}],"x-scopes":["messages:send","messages:read","templates:read","templates:write","numbers:read","webhooks:write"],"responses":{"200":{"description":"La clave.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"La cuota de la operación (borrador del IETF `ratelimit-headers`): `\"send\";q=600;w=60`.","schema":{"type":"string"}},"RateLimit":{"description":"Lo que queda de la cuota y cuántos segundos faltan para reponerla: `\"send\";r=598;t=42`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Key"},"examples":{"ejemplo_1":{"summary":"Una clave de envío","value":{"object":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Facturador producción","scopes":["messages:send","templates:read","numbers:read"],"numbers":["num_02y8w48sgGf2ztA7qbjqso"],"daily_sends":{"limit":1000,"used":312,"remaining":688,"resets_at":1790571600},"expires_at":null,"workspace":{"id":"ws_02y8w1U16yvllaqHECQC2Y","name":"Clínica Ejemplo"}}}}}}},"401":{"description":"`UNAUTHENTICATED`: Falta la clave. `API_KEY_INVALID`: La clave no es válida. `API_KEY_REVOKED`: La clave está revocada. `API_KEY_EXPIRED`: La clave caducó. `API_KEY_SUSPENDED`: La clave está suspendida.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"`FEATURE_NOT_ENABLED`: Esa función no está activa en este espacio. `INSUFFICIENT_SCOPE`: La clave no tiene ese permiso.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"El reto de autenticación (RFC 6750).","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"`RATE_LIMITED`: Demasiadas peticiones.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}},"Retry-After":{"description":"Segundos que esperar antes de reintentar.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"`INTERNAL`: Error interno.","headers":{"Request-Id":{"description":"El id de la petición (`req_…`): dalo al pedir ayuda.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"snw_live_…","description":"Una clave del espacio, creada en Desarrolladores."}},"schemas":{"Message":{"type":"object","properties":{"object":{"type":"string","const":"message"},"id":{"type":"string","pattern":"^msg_[0-9A-Za-z]{22}$","description":"El id del mensaje (`msg_…`).","examples":["msg_02y9HflgNTRjaQMubfP6vm"]},"number":{"type":"object","properties":{"id":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","description":"El id del número (`num_…`).","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"phone":{"description":"El teléfono del número, en E.164.","type":["string","null"]}},"required":["id","phone"]},"contact":{"type":"object","properties":{"phone":{"description":"El teléfono del contacto, en E.164, si se conoce.","type":["string","null"]},"user_id":{"description":"El BSUID del contacto, si se conoce.","type":["string","null"]},"name":{"description":"El nombre de su perfil de WhatsApp. Solo con `messages:read`.","type":["string","null"]}},"required":["phone","user_id","name"],"description":"El contacto: por su teléfono o, si no lo muestra, por su BSUID."},"direction":{"type":"string","enum":["inbound","outbound"]},"type":{"type":"string","enum":["text","template","image","document","audio","video","sticker","location","contacts","interactive","button","reaction","unsupported"],"description":"El tipo. Lo que llega puede ser de más tipos que lo que se envía."},"text":{"description":"El texto, el comentario del archivo o el texto de la plantilla ya compuesto.","type":["string","null"]},"template":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"language":{"type":["string","null"]}},"required":["name","language"]},{"type":"null"}]},"media":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","pattern":"^med_[0-9A-Za-z]{22}$","description":"El id del archivo (`med_…`).","examples":["med_02y9HHPWRS3wHysjF22iwI"]},{"type":"null"}],"description":"El archivo subido por la API con que se envió; `null` en los demás."},"kind":{"type":"string"},"content_type":{"type":["string","null"]},"filename":{"type":["string","null"]},"caption":{"type":["string","null"]},"size_bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","kind","content_type","filename","caption","size_bytes"]},{"type":"null"}]},"status":{"type":"string","enum":["queued","sending","accepted","sent","delivered","read","failed","received"],"description":"`queued` y `sending`: en la cola. `accepted`, `sent`, `delivered` y `read`: lo que dice WhatsApp. `failed`: no salió (mira `error`). `received`: lo que llega."},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","description":"Por qué falló (catálogo de errores del mensaje)."},"message":{"type":"string"},"meta_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"El código de error de Meta, si viene de Meta."}},"required":["code","message","meta_code"]},{"type":"null"}]},"client_reference":{"description":"La referencia de tu sistema, tal como la enviaste.","type":["string","null"]},"sent_by":{"anyOf":[{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"api_key"},"id":{"type":"string","pattern":"^key_[0-9A-Za-z]{22}$","description":"El id de la clave (`key_…`).","examples":["key_02y9HfsYGgsLoqUuhdpNYk"]},"name":{"type":"string"}},"required":["type","id","name"]},{"type":"object","properties":{"type":{"type":"string","const":"member"},"name":{"type":["string","null"]}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","const":"system"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"business_app"}},"required":["type"]}]},{"type":"null"}],"description":"Quién pidió el envío: una clave, una persona de la consola, el sistema o la app WhatsApp Business del teléfono. `null` en lo que llega."},"whatsapp_id":{"description":"El id de WhatsApp (`wamid`), cuando WhatsApp lo acepta.","type":["string","null"]},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Cuándo se creó el mensaje (o cuándo llegó).","examples":[1790546400]},"status_updated_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Cuándo cambió su estado por última vez."},"expires_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Mientras sigue en cola: hasta cuándo se intenta enviar (`ttl`)."},"reply_to":{"description":"El `whatsapp_id` del mensaje al que responde, si responde a uno.","type":["string","null"]},"interactive":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["button_reply","list_reply","button"],"description":"Un botón o una opción de una lista, o el botón de una plantilla."},"id":{"description":"El id del botón o de la opción (el `payload` del botón de una plantilla).","type":["string","null"]},"title":{"type":["string","null"]}},"required":["type","id","title"]},{"type":"null"}],"description":"El botón o la opción que eligió el contacto."},"location":{"anyOf":[{"type":"object","properties":{"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"name":{"type":["string","null"]},"address":{"type":["string","null"]}},"required":["latitude","longitude","name","address"]},{"type":"null"}],"description":"La ubicación que compartió el contacto."},"reaction":{"anyOf":[{"type":"object","properties":{"emoji":{"type":["string","null"]},"message_whatsapp_id":{"description":"El `whatsapp_id` del mensaje al que reaccionó.","type":["string","null"]}},"required":["emoji","message_whatsapp_id"]},{"type":"null"}],"description":"Una reacción a otro mensaje. Sin `emoji`, quitó su reacción."},"referral":{"anyOf":[{"type":"object","properties":{"source_type":{"type":["string","null"]},"source_id":{"type":["string","null"]},"source_url":{"type":["string","null"]},"headline":{"type":["string","null"]},"ctwa_clid":{"type":["string","null"]}},"required":["source_type","source_id","source_url","headline","ctwa_clid"]},{"type":"null"}],"description":"El anuncio que trajo al contacto (clic a WhatsApp), si vino por uno."}},"required":["object","id","number","contact","direction","type","text","template","media","status","error","client_reference","sent_by","whatsapp_id","created_at","status_updated_at","expires_at","reply_to","interactive","location","reaction","referral"],"description":"Un mensaje de WhatsApp, enviado o recibido."},"MessageList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Message"}},"has_more":{"type":"boolean"},"next_cursor":{"description":"Para la página siguiente, con los mismos filtros; `null` al final.","type":["string","null"]}},"required":["object","data","has_more","next_cursor"],"description":"Una página de mensajes, del más reciente al más antiguo."},"Number":{"type":"object","properties":{"object":{"type":"string","const":"number"},"id":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","description":"El id del número (`num_…`).","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"phone":{"description":"El teléfono, en E.164.","type":["string","null"]},"display_name":{"description":"El nombre verificado en WhatsApp.","type":["string","null"]},"label":{"description":"La etiqueta que le puso el espacio.","type":["string","null"]},"mode":{"type":"string","enum":["coexistence","cloud_api"],"description":"Cómo está conectado: junto a la app de WhatsApp Business o solo por la API."},"status":{"type":"string","enum":["active","disconnected"]},"quality":{"type":"string","enum":["green","yellow","red","unknown"],"description":"La calidad según Meta."},"messaging_limit":{"description":"El límite de mensajería de Meta (`TIER_1K`…). Meta lo está retirando: puede ser `null`.","type":["string","null"]},"can_send":{"type":"string","enum":["available","limited","blocked","unknown"],"description":"Si WhatsApp deja enviar desde aquí."},"issues":{"type":"array","items":{"type":"object","properties":{"code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"title":{"type":"string"},"solution":{"type":"string"}},"required":["code","title","solution"]},"description":"Los problemas que informa Meta del número, con su solución en español."},"whatsapp_account":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^wa_[0-9A-Za-z]{22}$","description":"El id de la cuenta de WhatsApp Business (`wa_…`).","examples":["wa_02y8w2MyKl4wS3UC9VNwwo"]},"name":{"type":["string","null"]},"can_send":{"type":"string","enum":["available","limited","blocked","unknown"],"description":"Si WhatsApp deja enviar desde aquí."}},"required":["id","name","can_send"]},{"type":"null"}],"description":"Su cuenta de WhatsApp Business."},"connected_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Cuándo se conectó.","examples":[1790546400]}},"required":["object","id","phone","display_name","label","mode","status","quality","messaging_limit","can_send","issues","whatsapp_account","connected_at"],"description":"Un número de WhatsApp del espacio."},"NumberList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Number"}},"has_more":{"type":"boolean"},"next_cursor":{"description":"Para la página siguiente, con los mismos filtros; `null` al final.","type":["string","null"]}},"required":["object","data","has_more","next_cursor"],"description":"Los números que alcanza la clave."},"Template":{"type":"object","properties":{"object":{"type":"string","const":"template"},"name":{"type":"string"},"language":{"type":"string"},"category":{"type":"string","description":"`UTILITY`, `MARKETING` o `AUTHENTICATION`, como en Meta."},"status":{"type":"string","description":"`APPROVED`, `PENDING`, `REJECTED`, `PAUSED`…, como en Meta."},"whatsapp_account":{"anyOf":[{"type":"string","pattern":"^wa_[0-9A-Za-z]{22}$","description":"El id de la cuenta de WhatsApp Business (`wa_…`).","examples":["wa_02y8w2MyKl4wS3UC9VNwwo"]},{"type":"null"}]},"sendable":{"type":"boolean","description":"Si se puede enviar por la API ahora."},"not_sendable_reason":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},{"type":"null"}]},"fields":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"Dónde va el dato en `POST /v1/messages` (`template.params.body.nombre`)."},"type":{"type":"string","enum":["text","url_suffix","coupon","payload","media"]},"media_kind":{"anyOf":[{"type":"string","enum":["image","document"]},{"type":"null"}]},"label":{"type":"string"},"required":{"type":"boolean"},"example":{"type":["string","null"]},"max_length":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["path","type","media_kind","label","required","example","max_length"]},"description":"Los datos que pide al enviarla, en orden."},"preview":{"type":"object","properties":{"header":{"type":["string","null"]},"body":{"type":["string","null"]},"footer":{"type":["string","null"]},"buttons":{"type":"array","items":{"type":"string"}}},"required":["header","body","footer","buttons"]}},"required":["object","name","language","category","status","whatsapp_account","sendable","not_sendable_reason","fields","preview"],"description":"Una plantilla de la cuenta de WhatsApp Business del número."},"TemplateList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Template"}},"has_more":{"type":"boolean"},"next_cursor":{"description":"Para la página siguiente, con los mismos filtros; `null` al final.","type":["string","null"]}},"required":["object","data","has_more","next_cursor"],"description":"Las plantillas de la cuenta del número. No pagina: `has_more` siempre es `false`."},"DeletedTemplate":{"type":"object","properties":{"object":{"type":"string","const":"template"},"name":{"type":"string"},"deleted":{"type":"boolean","const":true}},"required":["object","name","deleted"]},"ReadReceipt":{"type":"object","properties":{"object":{"type":"string","const":"read_receipt"},"message":{"type":"string","pattern":"^msg_[0-9A-Za-z]{22}$","description":"El id del mensaje (`msg_…`).","examples":["msg_02y9HflgNTRjaQMubfP6vm"]},"status":{"type":"string","const":"queued","description":"En cola: sale en segundos, en el turno de su número."}},"required":["object","message","status"],"description":"El aviso de leído de un mensaje que llegó: el contacto verá los dos ticks azules."},"Media":{"type":"object","properties":{"object":{"type":"string","const":"media"},"id":{"type":"string","pattern":"^med_[0-9A-Za-z]{22}$","description":"El id del archivo (`med_…`).","examples":["med_02y9HHPWRS3wHysjF22iwI"]},"kind":{"type":"string","enum":["image","document"]},"content_type":{"type":"string"},"filename":{"type":"string","description":"El nombre con que se enviará: saneado y con la extensión de su formato."},"size_bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"renamed":{"type":"boolean","description":"Si el nombre cambió al sanearlo."},"expires_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Hasta cuándo se puede usar: 24 horas, y una sola vez.","examples":[1790546400]}},"required":["object","id","kind","content_type","filename","size_bytes","renamed","expires_at"],"description":"Un archivo subido para enviarlo en un mensaje."},"WebhookEndpoint":{"type":"object","properties":{"object":{"type":"string","const":"webhook_endpoint"},"id":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","description":"El id del endpoint de webhooks (`we_…`).","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]},"url":{"type":"string","description":"La URL que recibe los avisos, normalizada (el dominio en minúsculas, sin el fragmento)."},"description":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"},"description":"Los tipos que recibe, en el orden del catálogo: `message.received`, `message.status`, `message.echo`, `call.ended`, `template.status`, `number.connected`, `number.disconnected`, `number.quality`, `number.status`. Abierto: pueden aparecer tipos nuevos."},"numbers":{"anyOf":[{"type":"string","const":"all"},{"type":"array","items":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","description":"El id del número (`num_…`).","examples":["num_02y8w48sgGf2ztA7qbjqso"]}}],"description":"`\"all\"`: todos los números del espacio, también los que se conecten después. Si no, los ids de los números."},"api_version":{"type":"string","description":"La versión de los cuerpos que recibe (`v1`)."},"status":{"type":"string","enum":["active","paused","disabled","suspended"],"description":"`paused`: lo pausó alguien (lo pendiente espera). `disabled`: 72 horas fallando o respondió `410 Gone`. `suspended`: quien creó la clave ya no lo justifica. Los tres se reactivan en la consola."},"status_reason":{"description":"Por qué no está activo: `manual`, `failing`, `gone`, `author_removed`, `author_role_changed`, `author_scope_changed`, `author_disabled` o `platform`.","type":["string","null"]},"secret":{"description":"El secreto con que se firman los avisos (`whsec_…`), **solo** en la respuesta del alta: guárdalo entonces. Después, y al repetir el alta con la misma Idempotency-Key, `null`.","type":["string","null"]},"secret_hint":{"type":"string","description":"Los últimos 4 caracteres del secreto, para reconocerlo."},"health":{"type":"object","properties":{"failing":{"type":"boolean","description":"Si sus últimas entregas fallaron."},"consecutive_failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"failing_since":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Desde cuándo falla."},"last_attempt_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"El último intento de entrega."},"last_success_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"La última entrega con un 2xx."},"last_failure_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"El último fallo."},"last_failure_code":{"description":"El resultado del último fallo: `http_503`, `timeout`, `tls_certificate`…","type":["string","null"]}},"required":["failing","consecutive_failures","failing_since","last_attempt_at","last_success_at","last_failure_at","last_failure_code"],"description":"Cómo le está yendo. El registro de cada entrega está en la consola."},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Cuándo se creó.","examples":[1790546400]},"updated_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Su último cambio.","examples":[1790546400]}},"required":["object","id","url","description","events","numbers","api_version","status","status_reason","secret","secret_hint","health","created_at","updated_at"],"description":"Un endpoint de webhooks: la URL de tu sistema que recibe los avisos firmados."},"WebhookEndpointList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEndpoint"}},"has_more":{"type":"boolean"},"next_cursor":{"description":"Para la página siguiente, con los mismos filtros; `null` al final.","type":["string","null"]}},"required":["object","data","has_more","next_cursor"],"description":"Los endpoints que creó la clave (o las que reemplazó al rotarla), del más reciente al más antiguo. No pagina: `has_more` siempre es `false`."},"DeletedWebhookEndpoint":{"type":"object","properties":{"object":{"type":"string","const":"webhook_endpoint"},"id":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","description":"El id del endpoint de webhooks (`we_…`).","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]},"deleted":{"type":"boolean","const":true}},"required":["object","id","deleted"]},"WebhookTest":{"type":"object","properties":{"object":{"type":"string","const":"webhook_test"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del aviso de prueba: llega en su cabecera `webhook-id`.","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"endpoint":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","description":"El id del endpoint de webhooks (`we_…`).","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]},"type":{"type":"string","const":"webhook.test"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Cuándo se pidió.","examples":[1790546400]}},"required":["object","id","endpoint","type","created_at"],"description":"Una prueba en cola: sale en segundos, firmada como las demás y con un solo intento. Lo que respondió tu servidor se ve en la consola."},"Key":{"type":"object","properties":{"object":{"type":"string","const":"api_key"},"id":{"type":"string","pattern":"^key_[0-9A-Za-z]{22}$","description":"El id de la clave (`key_…`).","examples":["key_02y9HfsYGgsLoqUuhdpNYk"]},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["messages:send","messages:read","templates:read","templates:write","numbers:read","webhooks:write"]},"description":"Sus permisos."},"numbers":{"anyOf":[{"type":"string","const":"all"},{"type":"array","items":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","description":"El id del número (`num_…`).","examples":["num_02y8w48sgGf2ztA7qbjqso"]}}],"description":"Los números que alcanza: `\"all\"` (todos, también los que se conecten después) o sus ids."},"daily_sends":{"type":"object","properties":{"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Su tope de envíos del día."},"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Los de hoy: suyos y de las claves que reemplazó al rotarla."},"remaining":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resets_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"La próxima medianoche, hora de Ecuador, cuando vuelve a cero.","examples":[1790546400]}},"required":["limit","used","remaining","resets_at"],"description":"El tope de envíos del día, por linaje: rotar la clave no da otro."},"expires_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Cuándo caduca; `null`: no caduca."},"workspace":{"type":"object","properties":{"id":{"type":"string","pattern":"^ws_[0-9A-Za-z]{22}$","description":"El id del espacio (`ws_…`).","examples":["ws_02y8w1U16yvllaqHECQC2Y"]},"name":{"type":"string"}},"required":["id","name"],"description":"El espacio de la clave."}},"required":["object","id","name","scopes","numbers","daily_sends","expires_at","workspace"],"description":"La clave con que llamas: sus permisos, sus números, sus envíos de hoy y su espacio. Nunca su secreto."},"Call":{"type":"object","properties":{"object":{"type":"string","const":"call"},"id":{"type":"string","pattern":"^call_[0-9A-Za-z]{22}$","description":"El id de la llamada (`call_…`).","examples":["call_02y8w6a0N4oqwFc47YdMac"]},"number":{"type":"object","properties":{"id":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","description":"El id del número (`num_…`).","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"phone":{"description":"El teléfono del número, en E.164.","type":["string","null"]}},"required":["id","phone"]},"contact":{"type":"object","properties":{"phone":{"description":"El teléfono del contacto, en E.164, si se conoce.","type":["string","null"]},"user_id":{"description":"El BSUID del contacto, si se conoce.","type":["string","null"]},"name":{"description":"El nombre de su perfil de WhatsApp.","type":["string","null"]}},"required":["phone","user_id","name"],"description":"El contacto: por su teléfono o, si no lo muestra, por su BSUID."},"direction":{"type":"string","enum":["inbound","outbound"],"description":"`inbound`: llamó el contacto. `outbound`: lo llamó alguien del equipo."},"result":{"type":"string","enum":["completed","missed","no_answer","declined","canceled","failed","expired"],"description":"Cómo terminó: `completed` (hubo conversación), `missed` (entrante sin contestar), `no_answer` (saliente sin contestar), `declined` (el contacto la rechazó), `canceled` (colgó quien llamaba antes de que contestaran), `failed` (un error de WhatsApp o de conexión, en `error`) o `expired` (no llegó su final y se cerró sola)."},"agent":{"anyOf":[{"type":"object","properties":{"name":{"type":["string","null"]}},"required":["name"]},{"type":"null"}],"description":"Quién llamó o contestó, del equipo; `null` si nadie."},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Cuándo empezó a sonar, o cuándo se pidió la saliente.","examples":[1790546400]},"started_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Cuándo se contestó."},"ended_at":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Cuándo terminó."},"duration_sec":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Los segundos de conversación, según WhatsApp; `null` si no se contestó."},"billable_pulses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Los pulsos de 6 s que cobra WhatsApp: solo en las salientes contestadas."},"error":{"anyOf":[{"type":"object","properties":{"code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"El código de error de WhatsApp."},"title":{"type":["string","null"]}},"required":["code","title"]},{"type":"null"}],"description":"El error de WhatsApp, si lo hubo."}},"required":["object","id","number","contact","direction","result","agent","created_at","started_at","ended_at","duration_sec","billable_pulses","error"],"description":"Una llamada de WhatsApp, entrante o saliente, ya terminada."},"SendMessageRequest":{"oneOf":[{"type":"object","properties":{"number":{"description":"Desde qué número se envía.","type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"to":{"type":"string","minLength":3,"maxLength":80,"description":"El destino: un teléfono en formato internacional (`+593991234567`) o el BSUID del contacto.","examples":["+593991234567"]},"client_reference":{"description":"Tu referencia (una factura, una cita). Vuelve en el mensaje y sirve para filtrar. No es única.","type":"string","minLength":1,"maxLength":128},"ttl":{"description":"Segundos que se intenta enviar antes de darlo por vencido (`expired`). Por omisión, 86.400 (24 horas).","type":"integer","minimum":60,"maximum":86400},"type":{"type":"string","const":"text"},"text":{"type":"object","properties":{"body":{"type":"string","minLength":1,"maxLength":4096,"description":"El texto: hasta 1.024 caracteres. Solo dentro de las 24 horas desde el último mensaje del contacto."}},"required":["body"],"additionalProperties":false}},"required":["number","to","type","text"],"additionalProperties":false},{"type":"object","properties":{"number":{"description":"Desde qué número se envía.","type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"to":{"type":"string","minLength":3,"maxLength":80,"description":"El destino: un teléfono en formato internacional (`+593991234567`) o el BSUID del contacto.","examples":["+593991234567"]},"client_reference":{"description":"Tu referencia (una factura, una cita). Vuelve en el mensaje y sirve para filtrar. No es única.","type":"string","minLength":1,"maxLength":128},"ttl":{"description":"Segundos que se intenta enviar antes de darlo por vencido (`expired`). Por omisión, 86.400 (24 horas).","type":"integer","minimum":60,"maximum":86400},"type":{"type":"string","const":"template"},"template":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":512},"language":{"description":"El idioma de la plantilla (`es`, `es_MX`…). Por omisión, `es`.","type":"string","minLength":2,"maxLength":15},"params":{"description":"Los datos que pide la plantilla: `GET /v1/templates` dice cuáles, con su ruta.","type":"object","properties":{"header":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$"},"additionalProperties":{"type":"string","maxLength":2000},"description":"Nombre de la variable (o su posición, o el índice del botón) → texto. Hasta 30 datos."},"body":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$"},"additionalProperties":{"type":"string","maxLength":2000},"description":"Nombre de la variable (o su posición, o el índice del botón) → texto. Hasta 30 datos."},"buttons":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Za-z0-9_]{1,64}$"},"additionalProperties":{"type":"string","maxLength":2000},"description":"Nombre de la variable (o su posición, o el índice del botón) → texto. Hasta 30 datos."},"header_media":{"description":"El archivo del encabezado, si la plantilla lleva imagen o documento.","type":"object","properties":{"media_id":{"description":"El archivo subido con `POST /v1/media`.","type":"string","pattern":"^med_[0-9A-Za-z]{22}$","examples":["med_02y9HHPWRS3wHysjF22iwI"]}},"required":["media_id"],"additionalProperties":false}},"additionalProperties":false}},"required":["name"],"additionalProperties":false}},"required":["number","to","type","template"],"additionalProperties":false},{"type":"object","properties":{"number":{"description":"Desde qué número se envía.","type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"to":{"type":"string","minLength":3,"maxLength":80,"description":"El destino: un teléfono en formato internacional (`+593991234567`) o el BSUID del contacto.","examples":["+593991234567"]},"client_reference":{"description":"Tu referencia (una factura, una cita). Vuelve en el mensaje y sirve para filtrar. No es única.","type":"string","minLength":1,"maxLength":128},"ttl":{"description":"Segundos que se intenta enviar antes de darlo por vencido (`expired`). Por omisión, 86.400 (24 horas).","type":"integer","minimum":60,"maximum":86400},"type":{"type":"string","const":"image"},"image":{"type":"object","properties":{"media_id":{"description":"El archivo subido con `POST /v1/media`.","type":"string","pattern":"^med_[0-9A-Za-z]{22}$","examples":["med_02y9HHPWRS3wHysjF22iwI"]},"caption":{"description":"Hasta 1.024 caracteres.","type":"string","maxLength":4096}},"required":["media_id"],"additionalProperties":false}},"required":["number","to","type","image"],"additionalProperties":false},{"type":"object","properties":{"number":{"description":"Desde qué número se envía.","type":"string","pattern":"^num_[0-9A-Za-z]{22}$","examples":["num_02y8w48sgGf2ztA7qbjqso"]},"to":{"type":"string","minLength":3,"maxLength":80,"description":"El destino: un teléfono en formato internacional (`+593991234567`) o el BSUID del contacto.","examples":["+593991234567"]},"client_reference":{"description":"Tu referencia (una factura, una cita). Vuelve en el mensaje y sirve para filtrar. No es única.","type":"string","minLength":1,"maxLength":128},"ttl":{"description":"Segundos que se intenta enviar antes de darlo por vencido (`expired`). Por omisión, 86.400 (24 horas).","type":"integer","minimum":60,"maximum":86400},"type":{"type":"string","const":"document"},"document":{"type":"object","properties":{"media_id":{"description":"El archivo subido con `POST /v1/media`.","type":"string","pattern":"^med_[0-9A-Za-z]{22}$","examples":["med_02y9HHPWRS3wHysjF22iwI"]},"caption":{"description":"Hasta 1.024 caracteres.","type":"string","maxLength":4096}},"required":["media_id"],"additionalProperties":false}},"required":["number","to","type","document"],"additionalProperties":false}],"description":"Un mensaje: texto, plantilla, foto o documento. `type` dice cuál de `text`, `template`, `image` o `document` va; los demás no."},"CreateTemplateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":512,"description":"Minúsculas, números y guiones bajos."},"language":{"type":"string","maxLength":12},"category":{"type":"string","enum":["UTILITY","MARKETING"]},"header":{"description":"Con imagen o documento, la muestra va en la parte `sample` del multipart.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":200}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"image"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"document"}},"required":["type"],"additionalProperties":false}]},"body":{"type":"string","maxLength":4096,"description":"El texto, con variables con nombre: `{{nombre}}`."},"footer":{"type":"string","maxLength":200},"examples":{"description":"Un ejemplo por variable: Meta los pide para revisarla.","type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"type":"string","maxLength":1100}},"buttons":{"maxItems":20,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"quick_reply"},"text":{"type":"string","maxLength":200}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"url"},"text":{"type":"string","maxLength":200},"url":{"type":"string","maxLength":2100},"example":{"type":"string","maxLength":2100}},"required":["type","text","url"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"phone"},"text":{"type":"string","maxLength":200},"phone":{"type":"string","maxLength":40}},"required":["type","text","phone"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"copy_code"},"example":{"type":"string","maxLength":100}},"required":["type","example"],"additionalProperties":false}]}}},"required":["name","language","category","body"],"additionalProperties":false,"description":"El borrador de una plantilla, como en la consola."},"CreateWebhookEndpointRequest":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":2048,"description":"La URL de tu sistema: `https://`, un dominio público (no una IP) y el puerto 443 u 8443. Se comprueba su DNS.","examples":["https://api.tuempresa.com/webhooks/stacknetic"]},"description":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Para reconocerlo, hasta 200 caracteres."},"events":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"description":"Lo que quieres recibir, al menos un tipo: `message.received`, `message.status`, `message.echo`, `call.ended`, `template.status`, `number.connected`, `number.disconnected`, `number.quality`, `number.status`. No hay comodín. Los que llevan datos de las conversaciones (`message.*` y `call.ended`) piden además el permiso `messages:read`."},"numbers":{"anyOf":[{"type":"string","const":"all"},{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","description":"El id del número (`num_…`).","examples":["num_02y8w48sgGf2ztA7qbjqso"]}}],"description":"De qué números: `\"all\"` (todos, también los que se conecten después; pide una clave con todos los números) o una lista de ids."}},"required":["url","events","numbers"],"additionalProperties":false,"description":"Un endpoint nuevo: la URL, qué eventos y de qué números."},"UpdateWebhookEndpointRequest":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":2048,"description":"La URL de tu sistema: `https://`, un dominio público (no una IP) y el puerto 443 u 8443. Se comprueba su DNS.","examples":["https://api.tuempresa.com/webhooks/stacknetic"]},"description":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Para reconocerlo, hasta 200 caracteres."},"events":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"description":"Lo que quieres recibir, al menos un tipo: `message.received`, `message.status`, `message.echo`, `call.ended`, `template.status`, `number.connected`, `number.disconnected`, `number.quality`, `number.status`. No hay comodín. Los que llevan datos de las conversaciones (`message.*` y `call.ended`) piden además el permiso `messages:read`."},"numbers":{"anyOf":[{"type":"string","const":"all"},{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","pattern":"^num_[0-9A-Za-z]{22}$","description":"El id del número (`num_…`).","examples":["num_02y8w48sgGf2ztA7qbjqso"]}}],"description":"De qué números: `\"all\"` (todos, también los que se conecten después; pide una clave con todos los números) o una lista de ids."}},"additionalProperties":false,"description":"Lo que cambia; lo que no va se queda como estaba. Una URL nueva se vuelve a comprobar."},"MessageReceivedEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"message.received"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/Message"}},"required":["message"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"MessageStatusEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"message.status"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/Message"},"pricing":{"anyOf":[{"type":"object","properties":{"billable":{"type":["boolean","null"]},"category":{"type":["string","null"]},"type":{"type":["string","null"]},"model":{"type":["string","null"]}},"required":["billable","category","type","model"],"additionalProperties":false,"description":"Lo que Meta dice del cobro del mensaje: si se cobra, la categoría, el tipo y el modelo. Los valores los pone Meta y pueden crecer."},{"type":"null"}]}},"required":["message","pricing"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"MessageEchoEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"message.echo"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/Message"}},"required":["message"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"CallEndedEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"call.ended"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"call":{"$ref":"#/components/schemas/Call"}},"required":["call"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"TemplateStatusEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"template.status"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"template":{"type":"object","properties":{"object":{"type":"string","const":"template"},"name":{"type":"string"},"language":{"type":["string","null"]},"status":{"type":"string","description":"En mayúsculas, como Meta: `APPROVED`, `REJECTED`, `PAUSED`, `DISABLED`…"},"whatsapp_account":{"anyOf":[{"type":"string","pattern":"^wa_[0-9A-Za-z]{22}$","description":"El id de la cuenta de WhatsApp Business (`wa_…`).","examples":["wa_02y8w2MyKl4wS3UC9VNwwo"]},{"type":"null"}]}},"required":["object","name","language","status","whatsapp_account"],"additionalProperties":false},"reason":{"type":["string","null"]}},"required":["template","reason"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"NumberConnectedEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"number.connected"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"number":{"$ref":"#/components/schemas/Number"},"reconnected":{"type":"boolean"}},"required":["number","reconnected"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"NumberDisconnectedEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"number.disconnected"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"number":{"$ref":"#/components/schemas/Number"},"reason":{"type":"string","enum":["workspace","partner_removed","platform"]},"partner":{"anyOf":[{"type":"object","properties":{"reason":{"type":["string","null"]},"initiated_by":{"type":["string","null"]}},"required":["reason","initiated_by"],"additionalProperties":false},{"type":"null"}]}},"required":["number","reason","partner"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"NumberQualityEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"number.quality"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"number":{"$ref":"#/components/schemas/Number"},"previous":{"type":"object","properties":{"quality":{"type":"string","enum":["green","yellow","red","unknown"]},"messaging_limit":{"type":["string","null"]}},"required":["quality","messaging_limit"],"additionalProperties":false}},"required":["number","previous"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"NumberStatusEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"number.status"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"number":{"$ref":"#/components/schemas/Number"},"previous":{"type":"object","properties":{"can_send":{"type":"string","enum":["available","limited","blocked","unknown"]}},"required":["can_send"],"additionalProperties":false}},"required":["number","previous"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"WebhookTestEvent":{"type":"object","properties":{"object":{"type":"string","const":"event"},"id":{"type":"string","pattern":"^evt_[0-9A-Za-z]{22}$","description":"El id del evento (`evt_…`).","examples":["evt_02y9Hg6I37jaHgkutafuog"]},"type":{"type":"string","const":"webhook.test"},"api_version":{"type":"string","const":"v1"},"created_at":{"type":"integer","minimum":0,"maximum":9007199254740991},"data":{"type":"object","properties":{"endpoint":{"type":"string","pattern":"^we_[0-9A-Za-z]{22}$","description":"El id del endpoint de webhooks (`we_…`).","examples":["we_02y8w4hE8Lo89zo8KTrC1e"]},"requested_at":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["endpoint","requested_at"],"additionalProperties":false}},"required":["object","id","type","api_version","created_at","data"],"additionalProperties":false},"Problem":{"type":"object","properties":{"type":{"type":"string","description":"El ancla del código en el catálogo de errores."},"title":{"type":"string","description":"El título del código, en español."},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"El estado HTTP."},"detail":{"type":"string","description":"Qué pasó y qué hacer, en español."},"code":{"type":"string","description":"El código estable del error (Anexo de errores). Abierto: pueden aparecer códigos nuevos."},"request_id":{"type":"string","pattern":"^req_[0-9A-Za-z]{22}$","description":"El id de la petición (`req_…`).","examples":["req_02y9HfzQ9uIy3GcuncFeBi"]},"errors":{"description":"Los problemas de cada campo, con su ruta en la petición (`template.params.body.nombre`) y su código.","type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["path","code","message"]}},"reason":{"description":"El motivo estable de `TEMPLATE_NOT_SENDABLE`, `UNSUPPORTED_MEDIA_TYPE`, `TEMPLATE_CATEGORY_NOT_ALLOWED` o `WEBHOOK_URL_INVALID`.","type":"string"},"meta":{"description":"El error de Meta, con `META_ERROR`.","type":"object","properties":{"code":{"type":["number","string","null"]},"subcode":{"type":["number","string","null"]}},"required":["code","subcode"]},"required_scopes":{"description":"Los alcances que pide la operación, con `INSUFFICIENT_SCOPE`.","type":"array","items":{"type":"string"}},"required_capability":{"description":"Lo que tiene que incluir el espacio, con `FEATURE_NOT_ENABLED`: `api` o `webhooks`.","type":"string"}},"required":["type","title","status","detail","code","request_id"],"description":"Un error, en el formato de RFC 9457 (`application/problem+json`)."}}},"webhooks":{"message.received":{"post":{"operationId":"event.message.received","summary":"Mensaje recibido","description":"Un contacto escribe a uno de tus números. Lleva datos de las conversaciones (el teléfono y el nombre del contacto; en los mensajes, también su texto): solo lo suscribe una clave con `messages:read` o quien puede leer las conversaciones.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageReceivedEvent"},"examples":{"ejemplo":{"summary":"Un contacto pulsa un botón de tu mensaje","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"message.received","api_version":"v1","created_at":1790547000,"data":{"message":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":"Ana Pérez"},"direction":"inbound","type":"interactive","text":"Confirmar cita","template":null,"media":null,"status":"received","error":null,"client_reference":null,"sent_by":null,"whatsapp_id":"wamid.HBgMNTkzOTkxMjM0NTY3FQIAEhggQTFCMkMzRDRFNUY2","created_at":1790546998,"status_updated_at":1790546998,"expires_at":null,"reply_to":"wamid.HBgMNTkzOTkxMjM0NTY3FQIAERgSMUQ3RjBBMkI2QjZBQTlGNjNBAA==","interactive":{"type":"button_reply","id":"confirmar_cita_8841","title":"Confirmar cita"},"location":null,"reaction":null,"referral":null}}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"message.status":{"post":{"operationId":"event.message.status","summary":"Estado de un mensaje","description":"Un mensaje que enviaste se envió, se entregó, se leyó o falló. Lleva datos de las conversaciones (el teléfono y el nombre del contacto; en los mensajes, también su texto): solo lo suscribe una clave con `messages:read` o quien puede leer las conversaciones.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageStatusEvent"},"examples":{"ejemplo":{"summary":"Un mensaje que enviaste se entregó","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"message.status","api_version":"v1","created_at":1790546412,"data":{"message":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"template","text":"Hola Ana, te esperamos el martes 12 de octubre a las 10:00.","template":{"name":"recordatorio_cita","language":"es"},"media":null,"status":"delivered","error":null,"client_reference":"cita-8841","sent_by":{"type":"api_key","id":"key_02y9HfsYGgsLoqUuhdpNYk","name":"Agenda producción"},"whatsapp_id":"wamid.HBgMNTkzOTkxMjM0NTY3FQIAERgSMUQ3RjBBMkI2QjZBQTlGNjNBAA==","created_at":1790546400,"status_updated_at":1790546412,"expires_at":null,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null},"pricing":{"billable":true,"category":"utility","type":"regular","model":"PMP"}}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"message.echo":{"post":{"operationId":"event.message.echo","summary":"Mensaje desde el teléfono","description":"Alguien escribió desde la app WhatsApp Business del número. Lleva datos de las conversaciones (el teléfono y el nombre del contacto; en los mensajes, también su texto): solo lo suscribe una clave con `messages:read` o quien puede leer las conversaciones.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageEchoEvent"},"examples":{"ejemplo":{"summary":"Alguien escribe desde la app WhatsApp Business del número","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"message.echo","api_version":"v1","created_at":1790547300,"data":{"message":{"object":"message","id":"msg_02y9HflgNTRjaQMubfP6vm","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":null},"direction":"outbound","type":"text","text":"Le confirmo su cita del martes a las 10:00.","template":null,"media":null,"status":"sent","error":null,"client_reference":null,"sent_by":{"type":"business_app"},"whatsapp_id":"wamid.HBgMNTkzOTkxMjM0NTY3FQIAERgSRUNITzEyMzQ1Njc4","created_at":1790547299,"status_updated_at":1790547299,"expires_at":null,"reply_to":null,"interactive":null,"location":null,"reaction":null,"referral":null}}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"call.ended":{"post":{"operationId":"event.call.ended","summary":"Llamada terminada","description":"Terminó una llamada de WhatsApp, entrante o saliente, contestada o no: con su resultado, quién la atendió y cuánto duró. Lleva datos de las conversaciones (el teléfono y el nombre del contacto; en los mensajes, también su texto): solo lo suscribe una clave con `messages:read` o quien puede leer las conversaciones.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallEndedEvent"},"examples":{"ejemplo":{"summary":"Termina una llamada saliente que el contacto contestó","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"call.ended","api_version":"v1","created_at":1790547400,"data":{"call":{"object":"call","id":"call_02y8w6a0N4oqwFc47YdMac","number":{"id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312"},"contact":{"phone":"+593991234567","user_id":null,"name":"Ana Pérez"},"direction":"outbound","result":"completed","agent":{"name":"Carlos Ruiz"},"created_at":1790547190,"started_at":1790547200,"ended_at":1790547392,"duration_sec":192,"billable_pulses":32,"error":null}}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"template.status":{"post":{"operationId":"event.template.status","summary":"Estado de una plantilla","description":"Meta aprobó, rechazó, pausó o desactivó una plantilla.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateStatusEvent"},"examples":{"ejemplo":{"summary":"Meta aprueba una plantilla","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"template.status","api_version":"v1","created_at":1790547600,"data":{"template":{"object":"template","name":"recordatorio_cita","language":"es","status":"APPROVED","whatsapp_account":"wa_02y8w2MyKl4wS3UC9VNwwo"},"reason":null}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"number.connected":{"post":{"operationId":"event.number.connected","summary":"Número conectado","description":"Se conectó o se reconectó un número.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberConnectedEvent"},"examples":{"ejemplo":{"summary":"Se conecta un número","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"number.connected","api_version":"v1","created_at":1790200005,"data":{"number":{"object":"number","id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312","display_name":"Clínica Ejemplo","label":"Recepción","mode":"coexistence","status":"active","quality":"green","messaging_limit":"TIER_1K","can_send":"available","issues":[],"whatsapp_account":{"id":"wa_02y8w2MyKl4wS3UC9VNwwo","name":"Clínica Ejemplo","can_send":"available"},"connected_at":1790200000},"reconnected":false}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"number.disconnected":{"post":{"operationId":"event.number.disconnected","summary":"Número desconectado","description":"Un número dejó de estar conectado.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberDisconnectedEvent"},"examples":{"ejemplo":{"summary":"El negocio desconecta el número desde su app","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"number.disconnected","api_version":"v1","created_at":1790548200,"data":{"number":{"object":"number","id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312","display_name":"Clínica Ejemplo","label":"Recepción","mode":"coexistence","status":"disconnected","quality":"green","messaging_limit":"TIER_1K","can_send":"available","issues":[],"whatsapp_account":{"id":"wa_02y8w2MyKl4wS3UC9VNwwo","name":"Clínica Ejemplo","can_send":"available"},"connected_at":1790200000},"reason":"partner_removed","partner":{"reason":"INACTIVITY","initiated_by":"BUSINESS"}}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"number.quality":{"post":{"operationId":"event.number.quality","summary":"Calidad del número","description":"Cambió la calidad o el límite de mensajes de un número.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberQualityEvent"},"examples":{"ejemplo":{"summary":"Baja la calidad de un número","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"number.quality","api_version":"v1","created_at":1790548800,"data":{"number":{"object":"number","id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312","display_name":"Clínica Ejemplo","label":"Recepción","mode":"coexistence","status":"active","quality":"yellow","messaging_limit":"TIER_1K","can_send":"available","issues":[],"whatsapp_account":{"id":"wa_02y8w2MyKl4wS3UC9VNwwo","name":"Clínica Ejemplo","can_send":"available"},"connected_at":1790200000},"previous":{"quality":"green","messaging_limit":"TIER_1K"}}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"number.status":{"post":{"operationId":"event.number.status","summary":"Estado del número","description":"Un número pasó a poder o a no poder enviar.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberStatusEvent"},"examples":{"ejemplo":{"summary":"Un número deja de poder enviar","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"number.status","api_version":"v1","created_at":1790549400,"data":{"number":{"object":"number","id":"num_02y8w48sgGf2ztA7qbjqso","phone":"+593969847312","display_name":"Clínica Ejemplo","label":"Recepción","mode":"coexistence","status":"active","quality":"green","messaging_limit":"TIER_1K","can_send":"blocked","issues":[{"code":141006,"title":"Falta un método de pago en la cuenta de WhatsApp Business","solution":"Meta no deja iniciar conversaciones hasta que se añada un método de pago válido en WhatsApp Manager → Configuración de pagos."}],"whatsapp_account":{"id":"wa_02y8w2MyKl4wS3UC9VNwwo","name":"Clínica Ejemplo","can_send":"blocked"},"connected_at":1790200000},"previous":{"can_send":"available"}}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}},"webhook.test":{"post":{"operationId":"event.webhook.test","summary":"Prueba","description":"La manda «Enviar prueba» (en la consola o con `POST /v1/webhook-endpoints/{id}/test`). No se suscribe.","tags":["Webhooks"],"security":[],"externalDocs":{"description":"Cómo verificar la firma, los reintentos y el orden","url":"https://messaging.stack-netic.com/docs/webhooks"},"parameters":[{"name":"webhook-id","in":"header","required":true,"description":"El id del evento (`evt_…`): el mismo en cada reintento y en cada reenvío. Úsalo para no procesar dos veces el mismo aviso.","schema":{"type":"string"}},{"name":"webhook-timestamp","in":"header","required":true,"description":"Cuándo salió este intento, en segundos epoch UTC. Rechaza los que se alejen más de 5 minutos de tu hora.","schema":{"type":"string"}},{"name":"webhook-signature","in":"header","required":true,"schema":{"type":"string"},"description":"Una o dos firmas `v1,…` separadas por espacios (dos mientras rotas el secreto): HMAC-SHA256, en base64, de `{webhook-id}.{webhook-timestamp}.{cuerpo}` con la parte del secreto que sigue a `whsec_`, decodificada."},{"name":"stacknetic-event-type","in":"header","required":true,"description":"El tipo del evento, para enrutarlo sin leer el cuerpo.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestEvent"},"examples":{"ejemplo":{"summary":"«Enviar prueba», desde la consola o por la API","value":{"object":"event","id":"evt_02y9Hg6I37jaHgkutafuog","type":"webhook.test","api_version":"v1","created_at":1790550000,"data":{"endpoint":"we_02y8w4hE8Lo89zo8KTrC1e","requested_at":1790550000}}}}}}},"responses":{"410":{"description":"Ya no quieres avisos en esta URL: el endpoint se desactiva."},"2XX":{"description":"Recibido. Responde en menos de 15 segundos y procésalo después: cualquier otra respuesta, una redirección o un certificado no válido es un fallo, y se reintenta durante unas 72 horas."}}}}},"x-error-codes":{"BAD_REQUEST":{"status":400,"title":"La petición está mal formada"},"INVALID_CURSOR":{"status":400,"title":"El cursor no es válido"},"UNAUTHENTICATED":{"status":401,"title":"Falta la clave"},"API_KEY_INVALID":{"status":401,"title":"La clave no es válida"},"API_KEY_REVOKED":{"status":401,"title":"La clave está revocada"},"API_KEY_EXPIRED":{"status":401,"title":"La clave caducó"},"API_KEY_SUSPENDED":{"status":401,"title":"La clave está suspendida"},"FEATURE_NOT_ENABLED":{"status":403,"title":"Esa función no está activa en este espacio"},"INSUFFICIENT_SCOPE":{"status":403,"title":"La clave no tiene ese permiso"},"READ_ONLY":{"status":403,"title":"El espacio está en solo lectura"},"TEMPLATE_CATEGORY_NOT_ALLOWED":{"status":403,"title":"La clave no puede enviar esa categoría"},"WEBHOOK_EVENTS_NOT_ALLOWED":{"status":403,"title":"La clave no puede recibir esos eventos"},"WEBHOOK_CHANNELS_NOT_ALLOWED":{"status":403,"title":"Incluye números que la clave no alcanza"},"FORBIDDEN":{"status":403,"title":"No se puede hacer"},"NOT_FOUND":{"status":404,"title":"No existe"},"METHOD_NOT_ALLOWED":{"status":405,"title":"Método no admitido"},"CONFLICT":{"status":409,"title":"Conflicto"},"UPLOAD_USED":{"status":409,"title":"El archivo ya se usó"},"MEDIA_NOT_READY":{"status":409,"title":"El archivo todavía no está listo"},"IDEMPOTENCY_IN_PROGRESS":{"status":409,"title":"Esa petición se está procesando"},"WEBHOOK_LIMIT_REACHED":{"status":409,"title":"El espacio llegó a su máximo de endpoints"},"WEBHOOK_STATE_CONFLICT":{"status":409,"title":"El endpoint no admite eso en su estado"},"WABA_IN_OTHER_WORKSPACE":{"status":409,"title":"La cuenta de WhatsApp Business está en otro espacio"},"UPLOAD_EXPIRED":{"status":410,"title":"El archivo caducó"},"MEDIA_UNAVAILABLE":{"status":410,"title":"El archivo ya no está disponible"},"LENGTH_REQUIRED":{"status":411,"title":"Falta el tamaño"},"PAYLOAD_TOO_LARGE":{"status":413,"title":"Demasiado grande"},"UNSUPPORTED_MEDIA_TYPE":{"status":415,"title":"Tipo no admitido"},"RANGE_NOT_SATISFIABLE":{"status":416,"title":"El rango pedido no está en el archivo"},"VALIDATION_FAILED":{"status":422,"title":"Los datos no son válidos"},"TEMPLATE_NOT_FOUND":{"status":422,"title":"La plantilla no existe"},"TEMPLATE_NOT_SENDABLE":{"status":422,"title":"La plantilla no se puede enviar"},"MEDIA_REJECTED":{"status":422,"title":"WhatsApp no aceptó el archivo"},"IDEMPOTENCY_KEY_REUSED":{"status":422,"title":"Esa clave de idempotencia ya se usó con otra petición"},"MESSAGE_NOT_INBOUND":{"status":422,"title":"Ese mensaje no llegó de un contacto"},"WEBHOOK_URL_INVALID":{"status":422,"title":"La URL no sirve para un webhook"},"WEBHOOK_URL_UNRESOLVABLE":{"status":422,"title":"No encontramos ese dominio"},"WEBHOOK_URL_NOT_ALLOWED":{"status":422,"title":"Esa dirección no está permitida"},"WEBHOOK_EVENT_UNKNOWN":{"status":422,"title":"Ese evento no existe"},"RATE_LIMITED":{"status":429,"title":"Demasiadas peticiones"},"DAILY_LIMIT_REACHED":{"status":429,"title":"La clave llegó a su tope diario"},"QUEUE_FULL":{"status":429,"title":"Hay demasiados mensajes esperando"},"INTERNAL":{"status":500,"title":"Error interno"},"META_ERROR":{"status":502,"title":"WhatsApp no respondió como se esperaba"},"NOT_CONFIGURED":{"status":503,"title":"El número no puede enviar ahora"},"STORAGE_UNAVAILABLE":{"status":503,"title":"No se pudo guardar el archivo"},"BUSY":{"status":503,"title":"El servidor está ocupado con otros archivos"}}}