> ## Documentation Index > Fetch the complete documentation index at: https://docs.watahub.dev/llms.txt > Use this file to discover all available pages before exploring further. # Enviar un mensaje de WhatsApp > Enviar un mensaje de WhatsApp ## OpenAPI ````yaml es/openapi.json POST /v1/messages openapi: 3.1.0 info: title: Watahub API version: 0.2.0 description: >- API para clientes de Watahub, gateway multiempresa de WhatsApp Cloud API. Autentica cada solicitud con `Authorization: Bearer ` o `X-API-Key: `. Los contratos propios son cerrados; los registros de Meta conservan campos adicionales. El proxy `/vN.N` conserva el cuerpo y estado de Meta; acepta la versión de la ruta, pero la ignora. servers: - url: https://cloud.watahub.dev security: - bearerApiKey: [] - headerApiKey: [] tags: - name: Messages - name: Media - name: Templates - name: Graph-compatible proxy description: >- Compatibilidad con Graph de Meta en tres rutas. Devuelve la respuesta de Meta sin cambios. - name: Phones description: Teléfonos - name: Conversations description: Conversaciones - name: Connect description: Conexión - name: Customers description: Clientes - name: Webhooks description: Webhooks - name: Logs description: Registros - name: Health description: Estado del servicio - name: Message templates description: >- Plantillas por WABA en caché del gateway, sincronizadas desde Meta y necesarias para campañas. - name: Broadcasts description: >- Envía una plantilla aprobada a hasta 500 destinatarios; se procesa en cola y en segundo plano. paths: /v1/messages: post: tags: - Messages summary: Enviar un mensaje de WhatsApp description: >- El core transforma el cuerpo para `/messages` de Meta y devuelve su propio formato, sin `wa_id` ni `message_status`. Un `MetaError` 5XX en un envío indica `unknown_outcome`: podría haberse enviado. operationId: sendMessage requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SendMessage' responses: '200': $ref: '#/components/responses/MessageSent' 4XX: $ref: '#/components/responses/ClientError' 5XX: $ref: '#/components/responses/ServerError' components: schemas: SendMessage: type: object required: - to - kind description: >- Requiere el objeto correspondiente a `kind` (`media` para image, audio, video, document y sticker). properties: to: type: string minLength: 1 maxLength: 135 description: Teléfono del destinatario o ID de usuario con alcance empresarial. phoneNumberId: type: string pattern: ^\d{1,32}$ kind: type: string enum: - text - template - image - audio - video - document - reaction - interactive - location - contacts - sticker text: type: object required: - body properties: body: type: string minLength: 1 maxLength: 4096 template: type: object required: - name - language properties: name: type: string maxLength: 512 language: type: object required: - code properties: code: type: string minLength: 2 maxLength: 16 components: type: array items: type: object additionalProperties: true media: type: object description: >- Incluye id o link. Audio: sin caption/filename; voice solo en audio. Video: sin filename. properties: id: type: string pattern: ^\d{1,32}$ link: type: string format: uri caption: type: string maxLength: 1024 filename: type: string maxLength: 240 voice: type: boolean reaction: type: object required: - messageId - emoji properties: messageId: type: string maxLength: 256 emoji: type: string maxLength: 16 location: type: object required: - latitude - longitude properties: latitude: type: number minimum: -90 maximum: 90 longitude: type: number minimum: -180 maximum: 180 name: type: string maxLength: 256 address: type: string maxLength: 512 contacts: type: array minItems: 1 maxItems: 10 items: type: object additionalProperties: true description: Tarjeta de contacto de WhatsApp; requiere name.formatted_name. interactive: type: object additionalProperties: true description: >- Objeto interactive de Meta. Valida flow, location_request_message, cta_url, product, product_list y order_details. replyToMessageId: type: string maxLength: 256 SendMessageResult: type: object additionalProperties: false required: - success - messageId - recipient - phoneNumberId properties: success: const: true messageId: type: string description: '`messages[0].id` de Meta (wamid). Vacío si Meta no devuelve ninguno.' recipient: type: string description: >- `contacts[0].input` de Meta; en su defecto, teléfono enviado sin `+` o BSUID. phoneNumberId: type: string description: Número que envió el mensaje. GatewayError: type: object description: >- Error del gateway o core. `error` es un mensaje estable en inglés para desarrolladores. additionalProperties: false required: - error properties: error: type: string fields: type: array items: type: string description: 'Con 400 `Invalid fields`: rutas de los campos rechazados.' requestId: type: string description: 'Con 500 `Operation unavailable`: ID para facilitar a soporte.' ValidationError: type: object description: El core rechazó un valor del cuerpo, ruta, header o consulta. additionalProperties: false required: - error - details properties: error: const: Validation failed details: type: object description: Mensajes por nombre de campo. additionalProperties: type: array items: type: string MetaError: type: object description: >- Meta falló en `/v1`. Con error de Meta: `code`, `subcode`, `type` en envíos y clasificación del core. Si Meta es inaccesible o devuelve datos inutilizables, solo `message`, más `unknown_outcome` en envíos. additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - message properties: message: type: string code: type: integer description: >- Código de error de Meta; estado HTTP si Meta no proporciona código. subcode: type: integer description: '`error_subcode` de Meta.' type: type: string description: Tipo de error de Meta. Solo en envíos. category: type: string enum: - auth - billing - rate_limit - meta_server - unknown - unknown_outcome retryable: type: boolean action: type: string description: Qué hacer a continuación, en inglés. responses: MessageSent: description: Meta aceptó el mensaje. content: application/json: schema: $ref: '#/components/schemas/SendMessageResult' ClientError: description: >- Rechazado por el gateway (`GatewayError`), la validación del core (`ValidationError`, 422) o Meta (`MetaError`, con su estado HTTP). content: application/json: schema: anyOf: - $ref: '#/components/schemas/GatewayError' - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/MetaError' ServerError: description: >- `GatewayError` por fallo del gateway (500 con `requestId`, 503 por configuración ausente); `MetaError` por 5XX de Meta, conexión fallida (502) o timeout (504). content: application/json: schema: anyOf: - $ref: '#/components/schemas/GatewayError' - $ref: '#/components/schemas/MetaError' securitySchemes: bearerApiKey: type: http scheme: bearer description: Clave API de la cuenta. headerApiKey: type: apiKey in: header name: X-API-Key description: Clave API de la cuenta. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.