Quickstart

Consiga um token

Tokens são criados por um administrador do seu workspace da Sailer — qualquer pessoa com a permissão de Configuration. Peça um com o scope do que você planeja construir; veja Autenticação para a lista de scopes.Um token se parece com sk_live_AbC123.xYz789.... Ele é mostrado uma vez, na criação, e guardado só como hash — então coloque-o em um lugar seguro. Um token perdido não pode ser recuperado, só substituído.

Confirme que funciona

GET /v1/me descreve o próprio token. É o jeito mais barato de checar que a autenticação está ligada corretamente.

curl https://api.chatsailer.com/v1/me \
  -H "Authorization: Bearer $SAILER_API_TOKEN"

A resposta diz a qual workspace o token pertence e quais scopes ele carrega. Não há header de tenant para configurar: o workspace é implícito pelo token.

Leia alguns contatos

curl "https://api.chatsailer.com/v1/contacts?limit=5" \
  -H "Authorization: Bearer $SAILER_API_TOKEN"

{
  "data": [
    {
      "object": "contact",
      "id": "con_...",
      "first_name": "Ana",
      "last_name": "Ribeiro",
      "email": "ana@example.com",
      "phone": "+5511999999999",
      "status": "active",
      "custom_fields": { "segment": "enterprise", "annual_revenue": null },
      "created_at": "2026-08-14T12:04:11Z",
      "updated_at": "2026-08-29T09:31:52Z"
    }
  ],
  "meta": { "limit": 5, "has_more": true },
  "links": { "next": "https://api.chatsailer.com/v1/contacts?limit=5&cursor=..." }
}

Siga links.next para paginar o resto. Veja Paginação.

Crie um

curl -X POST https://api.chatsailer.com/v1/contacts \
  -H "Authorization: Bearer $SAILER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Bruno", "phone": "+5511987654321", "email": "bruno@example.com"}'

Isso precisa do scope contacts:write. first_name e phone são required; phone é único por workspace e guardado como E.164. Se o seu token não tem o scope, você recebe um 403 nomeando exatamente o que falta — veja Erros.

Autenticação

Scopes, e os dois limites que vale saber de antemão.

Referência da API

Cada endpoint, com um playground.

Primeiros passos

Trabalhando com a API

Próximo

Autenticação

Referência da API

​Próximo

Autenticação

Referência da API

Próximo