Autenticação

Todas as requisições à API do Klivo Chat precisam de autenticação via token de acesso pessoal.

Obtendo seu token de acesso

⚡

O token de acesso é vinculado ao seu usuário. Cada agente ou administrador tem o próprio token, com permissões correspondentes ao seu papel na plataforma.

Para gerar seu token:

Faça login em https://chat.klivo.marketing
Clique no seu avatar no canto inferior esquerdo
Acesse Configurações de Perfil
Role até a seção Token de Acesso no final da página
Copie o token gerado

Usando o token nas requisições

Inclua o token no header api_access_token de todas as requisições:

CURL

curl --request GET \
  --url https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations \
  --header 'api_access_token: SEU_TOKEN_AQUI'

PYTHON

import requests

headers = {
    "api_access_token": "SEU_TOKEN_AQUI"
}

response = requests.get(
    "https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations",
    headers=headers
)

print(response.json())

JAVASCRIPT

const response = await fetch(
  "https://chat.klivo.marketing/api/v1/accounts/{account_id}/conversations",
  {
    headers: {
      "api_access_token": "SEU_TOKEN_AQUI"
    }
  }
);

const data = await response.json();
console.log(data);

Encontrando seu account_id

O account_id aparece na URL do painel quando você está logado:

URL

https://chat.klivo.marketing/app/accounts/123/conversations
                                    ^^^

⚠️

Nunca compartilhe seu token de acesso publicamente. Qualquer pessoa com o token pode acessar sua conta com suas permissões. Se suspeitar de comprometimento, faça logout — isso invalida o token atual.

Erros de autenticação

Se o token for inválido ou ausente, a API retornará:

401 Erro

{
  "error": "Invalid Credentials"
}