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

# Atualizar uma sessão

> Este endpoint permite atualizar as chaves de sessão de um usuário específico e continuar a conversa iniciada anteriormente. O webhook desencadeado pela primeira resposta do usuário fornecerá o session_external_id necessário para esta solicitação.



## OpenAPI

````yaml open-api-files/treble-api-pt.json POST /session/{session_external_id}/update
openapi: 3.0.1
info:
  title: API do Treble Poll
  description: Documentação para o endpoint de implantação de polls no Treble
  version: 1.0.0
servers:
  - url: https://main.treble.ai
    description: Servidor principal do Treble
  - url: https://seudominio.com
    description: >-
      Servidor de exemplo para implementar os webhooks. Isso representa SEU
      servidor onde você deve implementar os endpoints que o Treble chamará.
security: []
tags:
  - name: Webhooks
    description: >-
      Endpoints que o Treble chamará no seu servidor. Estes não são endpoints
      reais que você possa chamar, mas uma representação dos webhooks que o
      Treble invocará no seu sistema.
paths:
  /session/{session_external_id}/update:
    post:
      summary: Atualizar sessão do usuário e continuar conversa
      description: >-
        Este endpoint permite atualizar as chaves de sessão de um usuário
        específico e continuar a conversa iniciada anteriormente. O webhook
        desencadeado pela primeira resposta do usuário fornecerá o
        session_external_id necessário para esta solicitação.
      parameters:
        - name: session_external_id
          in: path
          required: true
          description: >-
            ID externo da sessão do usuário. Obtido do campo
            'session_external_id' na resposta do webhook desencadeado pela
            primeira interação do usuário.
          schema:
            type: string
          example: f33b4734a2e5db671b59877ed3f662ec1f6332a0418c25de4868e35a
        - name: content-type
          in: header
          required: true
          schema:
            type: string
            enum:
              - application/json
      requestBody:
        description: Informações das chaves de sessão a serem atualizadas
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - user_session_keys
              properties:
                user_session_keys:
                  type: array
                  description: Lista de chaves de sessão do usuário a serem atualizadas
                  items:
                    $ref: '#/components/schemas/UserSessionKey'
            example:
              user_session_keys:
                - key: order
                  value: 1 Hambúrguer com queijo, 2 Refrigerantes
      responses:
        '200':
          description: Sessão atualizada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Mensagem de confirmação
                  session_id:
                    type: string
                    description: ID da sessão atualizada
              example:
                message: Sessão atualizada com sucesso
                session_id: f33b4734a2e5db671b59877ed3f662ec1f6332a0418c25de4868e35a
        '400':
          description: Erro na solicitação
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de erro
                  message:
                    type: string
                    description: Descrição do erro
        '404':
          description: Sessão não encontrada
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de erro
                  message:
                    type: string
                    description: Descrição do erro
components:
  schemas:
    UserSessionKey:
      type: object
      required:
        - key
        - value
      properties:
        key:
          type: string
          description: >-
            Nome da variável. Valores especiais incluem 'deployment_squad' para
            selecionar qual número de telefone realizará a implantação em
            empresas multicanal.
        value:
          type: string
          description: >-
            Valor da variável. Para 'deployment_squad', o valor deve ser
            'DS_[CELLPHONE]'.

````