> ## 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 texto en una conversación de la bandeja > Enviar texto en una conversación de la bandeja ## OpenAPI ````yaml es/openapi.json POST /v1/conversations/{conversationId}/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/conversations/{conversationId}/messages: parameters: - $ref: '#/components/parameters/ConversationId' post: tags: - Messages summary: Enviar texto en una conversación de la bandeja description: Se envía mediante `POST /v1/messages` y devuelve el mismo formato. operationId: sendConversationText parameters: - name: conversationId in: path required: true description: '`phoneNumberId:wa_id`, con dos puntos literales.' schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ConversationText' responses: '200': $ref: '#/components/responses/MessageSent' 4XX: $ref: '#/components/responses/ClientError' 5XX: $ref: '#/components/responses/ServerError' components: parameters: ConversationId: name: conversationId in: path required: true description: '`{phoneNumberId}:{waId}` codificado para URL.' schema: type: string schemas: ConversationText: type: object additionalProperties: false required: - text properties: text: type: string minLength: 1 maxLength: 4096 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.