> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Generate visitor token > Gere um token de identificação para um visitante do site que foi autenticado usando seu próprio sistema. Um token de identificação retornado por esta API pode ser usado para passar informações sobre o visitante já autenticado para o widget de chat, para que ele trate o visitante como um contato conhecido. Isso permite que os agentes de suporte reconheçam e auxiliem o visitante com mais eficiência. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/conversations-visitor-identification-v2026-09.json POST /visitor-identification/2026-09/tokens/create openapi: 3.0.1 info: title: Conversations Visitor Identification description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: PROFESSIONAL sales: PROFESSIONAL service: PROFESSIONAL cms: PROFESSIONAL commerce: PROFESSIONAL crmHub: PROFESSIONAL dataHub: PROFESSIONAL servers: - url: https://api.hubapi.com security: [] tags: - name: Basic paths: /visitor-identification/2026-09/tokens/create: post: tags: - Basic summary: Gerar token de visitante description: >- Gere um token de identificação para um visitante do site que foi autenticado usando seu próprio sistema. Um token de identificação retornado por esta API pode ser usado para passar informações sobre o visitante já autenticado para o widget de chat, para que ele trate o visitante como um contato conhecido. Isso permite que os agentes de suporte reconheçam e auxiliem o visitante com mais eficiência. operationId: post-/visitor-identification/2026-09/tokens/create_generateToken parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/IdentificationTokenGenerationRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/IdentificationTokenResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - conversations.visitor_identification.tokens.create components: schemas: IdentificationTokenGenerationRequest: required: - email - hsCustomerAgentContext type: object properties: email: type: string description: O e-mail do visitante que você deseja identificar firstName: type: string description: >- O nome do visitante que você deseja identificar. Esse valor somente será definido no HubSpot para contatos novos e existentes cujo nome seja desconhecido. Opcional. hsCustomerAgentContext: type: object additionalProperties: type: string description: >- Um objeto que contém contexto adicional sobre o Customer Agent. Esse campo é obrigatório e pode incluir várias propriedades de string. lastName: type: string description: >- O sobrenome do visitante que você deseja identificar. Esse valor somente será definido no HubSpot para contatos novos e existentes cujo sobrenome seja desconhecido. Opcional. IdentificationTokenResponse: required: - token type: object properties: token: type: string description: >- Um token de identificação que permite que o visitante seja tratado como um contato conhecido. Error: required: - category - correlationId - message type: object properties: category: type: string description: A categoria de erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: mais informações sobre o erro items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou as etapas de correção recomendadas message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado example: An error occurred subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa uma resposta de erro retornada pela API quando uma operação falha. Este componente é usado em vários endpoints para fornecer informações detalhadas sobre o erro encontrado. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: O código de status associado ao detalhe do erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: '{missingScopes=[scope1, scope2]}' in: type: string description: O nome do campo ou parâmetro no qual o erro foi encontrado. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa informações detalhadas sobre um erro ocorrido na API. Este componente é usado para fornecer contexto e detalhes adicionais sobre os erros, geralmente como parte de uma resposta de erro. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: conversations.visitor_identification.tokens.create: '' ````