> ## Documentation Index > Fetch the complete documentation index at: https://docs.rdstationmentoria.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Enviar mensagem > Envia mensagens para uma conversa (thread). As mensagens podem conter texto, imagem ou áudio. O modelo processará o conteúdo enviado e gerará a próxima mensagem da conversa com base no contexto. ## OpenAPI ````yaml https://chat.meuassistente.rdstationmentoria.com.br/docs post /api/{agentId} openapi: 3.0.3 info: title: Agents version: 0.0.1 servers: - url: https://chat.meuassistente.rdstationmentoria.com.br security: [] paths: /api/{agentId}: post: tags: - Chat summary: Enviar mensagem description: >- Envia mensagens para uma conversa (thread). As mensagens podem conter texto, imagem ou áudio. O modelo processará o conteúdo enviado e gerará a próxima mensagem da conversa com base no contexto. operationId: api parameters: - name: agentId in: path required: true schema: type: string description: Identificador do assistente requestBody: required: true content: application/json: schema: type: object properties: id: type: string description: >- A conversa para enviar a mensagem, ou `undefined` para iniciar uma nova conversa tools: type: array items: type: object properties: name: type: string description: Nome da ferramenta description: type: string description: Descrição da funcionalidade da ferramenta schema: type: object properties: type: type: string enum: - object default: object description: Tipo do schema, fixado como "object" properties: type: object properties: {} additionalProperties: true default: {} description: Propriedades definidas para a ferramenta required: type: array items: type: string default: [] description: Lista de campos obrigatórios no schema additionalProperties: type: boolean default: false description: Permite ou não propriedades adicionais additionalProperties: true description: >- Schema JSON que define os parâmetros aceitos por uma ferramenta required: - name - description - schema additionalProperties: false description: >- Estrutura de definição de uma ferramenta utilizável por um agente default: [] description: Ferramentas utilizadas pelo assistente preview: type: boolean default: false utm: type: object properties: source: type: string nullable: true description: Fonte (`utm_source`) medium: type: string nullable: true description: Meio (`utm_medium`) campaign: type: string nullable: true description: Campanha (`utm_campaign`) content: type: string nullable: true description: Conteúdo (`utm_content`) term: type: string nullable: true description: Termo (`utm_term`) additionalProperties: false description: Informações de rastreamento UTM format: type: string enum: - markdown - plain - whatsapp - slack description: >- Formata a resposta gerada pelo assistente para diferentes canais default: markdown leadId: type: string description: Identificador do lead platformUserIdentifier: type: string description: Identificador do usuário plataforma de origem message: type: object properties: role: type: string enum: - system - assistant - user - tool - function description: Define quem está enviando a mensagem content: type: string nullable: true default: null description: Conteúdo da mensagem name: type: string nullable: true default: null description: Nome do participante da conversa createdAt: type: string format: date-time default: '2026-02-08T00:20:48.482Z' description: Data de criação metadata: type: object additionalProperties: {} default: {} description: Metadados adicionais da mensagem toolCallId: type: string nullable: true default: null description: Identificador da chamada de ferramenta associada attachments: type: array items: type: object properties: type: type: string enum: - image - audio description: Tipos de anexos url: type: string description: URL do arquivo de mídia anexado content: type: string nullable: true default: null description: Conteúdo adicional ao anexo required: - type - url additionalProperties: false description: Anexo de mensagem nullable: true default: [] description: Anexos da mensagem required: - role additionalProperties: false nullable: true description: >- Mensagem única para adicionar neste turno da conversa e gerar uma resposta messages: type: array items: type: object properties: role: type: string enum: - system - assistant - user - tool - function description: Define quem está enviando a mensagem content: type: string nullable: true default: null description: Conteúdo da mensagem name: type: string nullable: true default: null description: Nome do participante da conversa createdAt: type: string format: date-time default: '2026-02-08T00:20:48.484Z' description: Data de criação metadata: type: object additionalProperties: {} default: {} description: Metadados adicionais da mensagem toolCallId: type: string nullable: true default: null description: Identificador da chamada de ferramenta associada attachments: type: array items: type: object properties: type: type: string enum: - image - audio description: Tipos de anexos url: type: string description: URL do arquivo de mídia anexado content: type: string nullable: true default: null description: Conteúdo adicional ao anexo required: - type - url additionalProperties: false description: Anexo de mensagem nullable: true default: [] description: Anexos da mensagem required: - role additionalProperties: false nullable: true default: [] description: >- Mensagens para adicionar neste turno da conversa e gerar uma resposta additionalProperties: false responses: '200': description: Successful response content: application/json: schema: type: object properties: id: type: string description: Identificador da conversa messages: type: array items: type: object properties: id: type: string description: Identificador da mensagem conversationId: type: string description: Identificador da conversa role: type: string enum: - system - assistant - user - tool - function description: Define quem está enviando a mensagem name: type: string nullable: true default: null description: Nome do participante da conversa content: type: string nullable: true default: null description: Conteúdo da mensagem toolCallId: type: string nullable: true default: null description: Identificador da chamada de ferramenta associada toolCalls: type: array items: type: object properties: id: type: string description: Identificador único da chamada de ferramenta type: type: string enum: - function description: Tipo da chamada, sempre `function` function: type: object properties: name: type: string description: Nome da função chamada pela ferramenta arguments: type: string description: >- Argumentos fornecidos como entrada para a função required: - name - arguments additionalProperties: false description: Chamada de função required: - id - type - function additionalProperties: false description: Chamada de ferramenta nullable: true default: null description: >- Lista de chamadas de ferramentas associadas à mensagem metadata: type: object additionalProperties: {} default: {} description: Metadados adicionais da mensagem feedback: type: boolean nullable: true default: null description: >- Feedback do usuário para a mensagem — `true` para positivo, `false` para negativo usage: type: object properties: promptTokens: type: number description: Quantidade de tokens usados no prompt completionTokens: type: number description: Quantidade de tokens usados na conclusão cachedTokens: type: number description: Quantidade de tokens recuperados do cache additionalProperties: false description: Informações de uso attachments: type: array items: type: object properties: type: type: string enum: - image - audio description: Tipos de anexos url: type: string description: URL do arquivo de mídia anexado content: type: string nullable: true default: null description: Conteúdo adicional ao anexo required: - type - url additionalProperties: false description: Anexo de mensagem nullable: true default: [] description: Anexos da mensagem createdAt: type: string format: date-time default: '2026-02-08T00:20:48.487Z' description: Data de criação updatedAt: type: string format: date-time default: '2026-02-08T00:20:48.487Z' description: Data da última atualização required: - id - conversationId - role - usage additionalProperties: false description: Mensagens geradas durante este turno da conversa lead: type: object properties: id: type: string description: Identificador do lead agentId: type: string description: Assistente que capturou o lead nullable: true default: null name: type: string nullable: true default: null description: Nome email: type: string nullable: true default: null description: Email phone: type: string nullable: true default: null description: Telefone company: type: string nullable: true default: null description: Empresa site: type: string nullable: true default: null description: Site custom: type: object additionalProperties: description: Valor do campo default: {} description: Campos utm: type: object properties: source: type: string nullable: true description: Fonte (`utm_source`) medium: type: string nullable: true description: Meio (`utm_medium`) campaign: type: string nullable: true description: Campanha (`utm_campaign`) content: type: string nullable: true description: Conteúdo (`utm_content`) term: type: string nullable: true description: Termo (`utm_term`) additionalProperties: false description: Informações de rastreamento UTM default: {} capture: type: string enum: - completed - partial description: Status da captura de dados do lead default: completed workspaceId: type: string description: Identificador do workspace associado createdAt: type: string format: date-time default: '2026-02-08T00:20:48.488Z' description: Data de criação updatedAt: type: string format: date-time default: '2026-02-08T00:20:48.488Z' description: Data da última atualização required: - id - workspaceId additionalProperties: false description: Dados do lead status: type: string enum: - active - finished description: Status required: - id - messages - status additionalProperties: false description: Resposta de uma conversa de chat com mensagens, status e lead default: $ref: '#/components/responses/error' security: - Authorization: [] components: responses: error: description: Error response content: application/json: schema: type: object properties: message: type: string code: type: string issues: type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false securitySchemes: Authorization: type: http scheme: bearer ````