> ## Documentation Index
> Fetch the complete documentation index at: https://developer.gptmaker.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Adicionar contexto

> Permite adicionar uma mensagem ao contexto da conversa, muito usado para quando fizer um disparo ativo por outras ferramentas e precisa adicionar essa mensagem ao contexto da conversa.



## OpenAPI

````yaml POST /v2/agent/{agentId}/add-message
openapi: 3.0.1
info:
  title: OpenAPI GPT Maker
  description: Documentação completa da API do GPT Maker
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.gptmaker.ai
security:
  - bearerAuth: []
paths:
  /v2/agent/{agentId}/add-message:
    post:
      description: >-
        Permite adicionar uma mensagem ao contexto da conversa, muito usado para
        quando fizer um disparo ativo por outras ferramentas e precisa adicionar
        essa mensagem ao contexto da conversa.
      parameters:
        - name: agentId
          in: path
          description: ID do agente
          required: true
          schema:
            type: string
      requestBody:
        description: Dados para mensagem a ser adicionada
        content:
          application/json:
            schema:
              oneOf:
                - title: Texto
                  type: object
                  properties:
                    contextId:
                      type: string
                      description: ID externo para identificar o cliente
                      example: '12345'
                    prompt:
                      type: string
                      description: Texto a ser salvo no contexto
                      example: oi você tem interesse no produto x?
                    role:
                      type: string
                      description: >-
                        define se é uma mensagem do usuário ou do agente, 'user'
                        ou 'assistant' default: 'assistant'
                  required:
                    - contextId
                    - prompt
                - title: Imagem
                  type: object
                  properties:
                    contextId:
                      type: string
                      description: ID externo para identificar o cliente
                      example: '12345'
                    prompt:
                      type: string
                      description: Texto a ser salvo no contexto
                      example: olha a foto desse produto x.
                    image:
                      type: string
                      description: URL da imagem
                      example: https://example.com/image.png
                    role:
                      type: string
                      description: >-
                        define se é uma mensagem do usuário ou do agente, 'user'
                        ou 'assistant' default: 'assistant'
                  required:
                    - contextId
                    - prompt
                    - image
                - title: Áudio
                  type: object
                  properties:
                    contextId:
                      type: string
                      description: ID externo para identificar o cliente
                      example: '12345'
                    audio:
                      type: string
                      description: URL do áudio
                      example: https://example.com/audio.mp3
                    role:
                      type: string
                      description: >-
                        define se é uma mensagem do usuário ou do agente, 'user'
                        ou 'assistant' default: 'assistant'
                  required:
                    - contextId
                    - audio
                - title: Vídeo
                  type: object
                  properties:
                    contextId:
                      type: string
                      description: ID externo para identificar o cliente
                      example: '12345'
                    video:
                      type: string
                      description: URL do vídeo
                      example: https://example.com/video.mp4
                    prompt:
                      type: string
                      description: Texto para o agente responder/caption do vídeo
                      example: o que você acha desse vídeo?
                    role:
                      type: string
                      description: >-
                        define se é uma mensagem do usuário ou do agente, 'user'
                        ou 'assistant' default: 'assistant'
                  required:
                    - contextId
                    - video
                - title: Documento
                  type: object
                  properties:
                    contextId:
                      type: string
                      description: ID externo para identificar o cliente
                      example: '12345'
                    document:
                      type: string
                      description: URL do documento a ser enviado
                      example: https://example.com/document.pdf
                    prompt:
                      type: string
                      description: Texto para o agente responder/caption do documento
                      example: o que você acha desse documento?
                    role:
                      type: string
                      description: >-
                        define se é uma mensagem do usuário ou do agente, 'user'
                        ou 'assistant' default: 'assistant'
                  required:
                    - contextId
                    - document
        required: true
      responses:
        '200':
          description: Resposta do agente
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Resposta do agente
                  images:
                    type: array
                    items:
                      type: string
                      description: URLs das imagens respondidas pelo agente
                  audios:
                    type: array
                    items:
                      type: string
                      description: URLs dos áudios respondidos pelo agente
        '400':
          description: Erro inesperado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Erro de token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error403'
components:
  schemas:
    Error:
      required:
        - error
      type: object
      properties:
        error:
          type: string
    Error403:
      required:
        - error
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````