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

# Gerar token do SDK

> Gera um token de sessão para abrir o SDK de conexão no frontend

## Conceituação

Este método gera um **token de sessão** para o [SDK de conexão](/partner/sdk-connector). O seu backend chama este endpoint com o seu Client-Token e devolve o `token` retornado para o frontend, que o usa em `ZAPIConnector.open({ token })`.

<Warning>
  A chamada deve ser feita pelo **seu backend**. Nunca exponha o seu Client-Token nem as credenciais da instância (instanceId e token) no frontend. O token gerado tem validade limitada — gere-o sob demanda, no momento em que o cliente for conectar.
</Warning>

Guia de implementação completo: [SDK de conexão](/partner/sdk-connector).

***

## Atributos

### Header

<ParamField path="instanceId" type="string" required>
  ID da sua instância. Disponível no painel Z-API em **Instâncias**.
</ParamField>

<ParamField path="token" type="string" required>
  Token da sua instância Z-API.
</ParamField>

***

## Response

### 200

<ResponseField name="token" type="string">
  Token de sessão a ser usado em `ZAPIConnector.open({ token })` no frontend
</ResponseField>

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```

### 405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.

### 415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json".