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

# Quickstart

> Faça a sua primeira requisição autenticada e leia um contato.

<Steps>
  <Step title="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](/pt-BR/guides/authentication)
    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.
  </Step>

  <Step title="Confirme que funciona">
    `GET /v1/me` descreve o próprio token. É o jeito mais barato de checar
    que a autenticação está ligada corretamente.

    ```bash theme={null}
    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.
  </Step>

  <Step title="Leia alguns contatos">
    ```bash theme={null}
    curl "https://api.chatsailer.com/v1/contacts?limit=5" \
      -H "Authorization: Bearer $SAILER_API_TOKEN"
    ```

    ```json theme={null}
    {
      "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](/pt-BR/guides/pagination).
  </Step>

  <Step title="Crie um">
    ```bash theme={null}
    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](/pt-BR/guides/errors).
  </Step>
</Steps>

## Próximo

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/pt-BR/guides/authentication">
    Scopes, e os dois limites que vale saber de antemão.
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference">
    Cada endpoint, com um playground.
  </Card>
</CardGroup>