> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metricaas.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Quem é este token

> Devolve a empresa, o papel, as capacidades efetivas e os **escopos de dados**
do token.

Comece por aqui quando um lead ou uma venda "não aparecer": na maioria das
vezes a resposta está em `scopes` — um token com `scopes.channels: ["whatsapp"]`
não enxerga lead do Instagram, e os totais mudam sem nenhum erro na resposta.




## OpenAPI

````yaml /openapi.yaml get /me
openapi: 3.1.0
info:
  title: Metricaas API
  version: 1.0.0
  description: >
    API do Metricaas para automatizar o CRM de fora dele — registrar vendas de
    uma

    plataforma de pagamento, ler leads e conferir a atribuição de origem.


    **Base:** `https://app.metricaas.com.br/v1`


    Todo endpoint é server-to-server. Não há CORS: um token de API nunca deve ir

    para o navegador.
servers:
  - url: https://app.metricaas.com.br/v1
security:
  - bearerAuth: []
tags:
  - name: Sessão
  - name: Leads
  - name: Vendas
paths:
  /me:
    get:
      tags:
        - Sessão
      summary: Quem é este token
      description: >
        Devolve a empresa, o papel, as capacidades efetivas e os **escopos de
        dados**

        do token.


        Comece por aqui quando um lead ou uma venda "não aparecer": na maioria
        das

        vezes a resposta está em `scopes` — um token com `scopes.channels:
        ["whatsapp"]`

        não enxerga lead do Instagram, e os totais mudam sem nenhum erro na
        resposta.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  token:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      mode:
                        type: string
                        enum:
                          - read
                          - write
                  client:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      name:
                        type: string
                      slug:
                        type: string
                  role:
                    type: string
                    example: manager
                  sees_all_leads:
                    type: boolean
                  scopes:
                    type: object
                    nullable: true
                    example:
                      channels:
                        - whatsapp
                  capabilities:
                    type: array
                    items:
                      type: string
        '401':
          $ref: '#/components/responses/NaoAutenticado'
components:
  responses:
    NaoAutenticado:
      description: Token ausente, inválido, expirado ou revogado
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problema'
  schemas:
    Problema:
      type: object
      description: Erros seguem RFC 7807.
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        `Authorization: Bearer mcp_…` — gere em **Configurações → Tokens de
        API**.


        O token tem modo `read` ou `write`. Um token `read` responde `403` a

        qualquer verbo que não seja `GET`. As capacidades do token são a

        **interseção** com as da pessoa que o emitiu: se ela perder acesso na

        grade de Equipe, o token perde junto, sem ninguém revogar nada.

````