Skip to main content
POST
Gerar código de migração (OTP)
Gera um código de uso único (8 caracteres, A-Z0-9) vinculado a uma sessão. O código é exibido ao usuário final, que o informa na extensão Assistente de Integração para migrar uma conexão do WhatsApp Web já autenticada para esta sessão — sem escanear o QR code.
  • Validade: 30 minutos.
  • Uso único: consumido na primeira migração bem-sucedida (uma falha mantém o código válido até expirar, permitindo nova tentativa).
  • Autenticação: sua apiKey no header Authorization. A sessão informada em sessionId precisa pertencer à sua conta.
Este endpoint apenas gera o código. A migração em si é feita pela extensão, que lê as credenciais da sessão do WhatsApp Web e as envia junto com o código. Veja Instalar o Assistente de Integração.
No painel, o código também aparece na tela Conectar dispositivo, logo abaixo do QR code, pronto para copiar.

Authorizations

Authorization
string
header
required

API Key para autenticação. Formato: <API_KEY>

Path Parameters

sessionId
string
required

ID (ou UUID) da sessão de destino.

Response

Código gerado

success
boolean
Example:

true

code
string
Example:

"A1B2C3D4"

expiresAt
string<date-time>
Example:

"2026-07-01T12:30:00.000Z"