> ## Documentation Index > Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt > Use this file to discover all available pages before exploring further. # Enviar mensaje > Mismo contrato PIV1 que los otros canales: `from` (Chat App), `to` (id de la conversación), `type` y `payload`. Con API Key, `senderExternalUserId` es obligatorio. Alcance: **chat:messages:send**. 1 crédito CHAT_MESSAGE. ## OpenAPI ````yaml /es/chat-api/api-reference/openapi-chat.json post /v1/chat/messages openapi: 3.0.3 info: title: Notifique API Chat description: >- Chat in-app: apps, usuarios, JWT, conversaciones y mensajes. Autentica con `Authorization: Bearer sk_live_...` (backend) o JWT del usuario. No envíes `x-workspace-id`. version: 1.0.0 servers: - url: https://api.notifique.dev description: Produção security: - ntfChatBearerAuth: [] - ntfChatApiKeyHeader: [] tags: - name: Chat Apps description: CRUD de Chat Apps e rotação do signing secret - name: Chat Users description: Usuários, JWT e agentes - name: Chat Conversations description: Conversas 1:1, grupos e membros - name: Chat Messages description: Envio, listagem e exclusão - name: Chat Blocks description: Bloqueo entre usuarios de la misma Chat App paths: /v1/chat/messages: post: tags: - Chat Messages summary: Enviar mensaje description: >- Mismo contrato PIV1 que los otros canales: `from` (Chat App), `to` (id de la conversación), `type` y `payload`. Con API Key, `senderExternalUserId` es obligatorio. Alcance: **chat:messages:send**. 1 crédito CHAT_MESSAGE. operationId: ntfChat_postV1ChatMessages requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NtfChat_SendMessageRequest' examples: text: summary: Texto value: from: clxxapp... to: - cnv_xxxxx type: text payload: message: Hola Alice, tu pedido salió a entrega. senderExternalUserId: agent:clxxuser... clientMessageId: msg_text_001 image: summary: Imagen value: from: clxxapp... to: - cnv_xxxxx type: image payload: mediaUrl: https://cdn.tusitio.com/comprobante.png message: Comprobante de entrega senderExternalUserId: user_alice audio: summary: Audio value: from: clxxapp... to: - cnv_xxxxx type: audio payload: mediaUrl: https://cdn.tusitio.com/nota.ogg senderExternalUserId: user_bob file: summary: Archivo value: from: clxxapp... to: - cnv_xxxxx type: file payload: mediaUrl: https://cdn.tusitio.com/contrato.pdf message: Contrato firmado senderExternalUserId: agent:clxxuser... jwt: summary: JWT del miembro value: to: - cnv_xxxxx type: text payload: message: Ya llegué reply: summary: Respuesta (reply) value: from: clxxapp... to: - cnv_xxxxx type: text payload: message: De acuerdo, gracias senderExternalUserId: agent:clxxuser... replyToId: clxxmsg... responses: '200': description: OK content: application/json: schema: type: object properties: success: type: boolean data: oneOf: - $ref: '#/components/schemas/NtfChat_Message' - type: array items: $ref: '#/components/schemas/NtfChat_Message' idempotent: type: boolean '401': description: API Key o JWT ausente/inválido. content: application/json: schema: $ref: '#/components/schemas/NtfChat_ErrorResponse' '402': description: Workspace bloqueado o créditos insuficientes. content: application/json: schema: $ref: '#/components/schemas/NtfChat_ErrorResponse' '403': description: Sin alcance, origen no permitido o JWT sin permiso. content: application/json: schema: $ref: '#/components/schemas/NtfChat_ErrorResponse' components: schemas: NtfChat_SendMessageRequest: type: object properties: from: type: string description: Id del Chat App. Si se informa, debe coincidir con la conversación. example: clxxapp... to: oneOf: - type: string example: cnv_xxxxx - type: array items: type: string example: - cnv_xxxxx description: Id de la conversación (string o lista). type: type: string enum: - text - image - audio - file example: text payload: type: object description: Contenido PIV1. Texto en message; media en mediaUrl (HTTPS). properties: message: type: string example: Olá caption: type: string mediaUrl: type: string format: uri example: https://cdn.example.com/a.png replyToId: type: string clientMessageId: type: string senderExternalUserId: type: string description: Obligatorio con API Key. externalUserId de USER o AGENT. example: user_alice clientMessageId: type: string example: msg_001 replyToId: type: string body: type: string description: Legado. Prefiera payload.message. mediaUrl: type: string description: Legado. Prefiera payload.mediaUrl. NtfChat_Message: type: object properties: id: type: string example: clxxmsg... conversationId: type: string example: cnv_xxxxx type: type: string enum: - TEXT - IMAGE - AUDIO - FILE example: TEXT body: type: string example: Oi, Alice createdAt: type: string format: date-time senderId: type: string mediaUrl: type: string nullable: true example: null replyToId: type: string nullable: true clientMessageId: type: string nullable: true example: msg_text_001 deletedAt: type: string format: date-time nullable: true sender: type: object properties: id: type: string externalUserId: type: string example: user_alice name: type: string nullable: true kind: type: string enum: - USER - AGENT example: USER NtfChat_ErrorResponse: type: object properties: success: type: boolean example: false error: type: string code: type: string message: type: string securitySchemes: ntfChatBearerAuth: type: http scheme: bearer description: API Key `sk_live_…` / `sk_test_…` ou JWT do usuário do chat (`eyJ…`). ntfChatApiKeyHeader: type: apiKey in: header name: x-api-key ````