---
title: "Crie uma chave de API de servidor"
description: "Gere uma chave secreta sk_live_ no painel para chamadas de servidor para servidor à API do ThunderPhone, mantenha-a segura e faça a rotação ou revogue-a quando necessário."
---

As chaves de API de servidor (`sk_live_...`) autenticam chamadas de servidor para servidor à API do ThunderPhone. As chaves ficam em **Organização → Chaves**.

<Warning>
  As chaves de servidor são segredos. Nunca inclua uma em código do lado do cliente — para
  navegadores, use
  [chaves publicáveis](/api-reference/publishable-keys) (`pk_live_...`) restritas por domínio
  em vez disso.
</Warning>

<Steps>
  <Step title="Abra a aba Chaves">
    Vá para **Organização → Chaves** e clique em **Criar chave**.
  </Step>
  <Step title="Dê um nome">
    Escolha um nome que indique onde a chave será usada — como "Backend de
    produção". Os nomes são apenas rótulos; não afetam o acesso.
  </Step>
  <Step title="Crie a chave">
    Clique em **Criar chave** na caixa de diálogo. Isso gera o segredo.
  </Step>
  <Step title="Copie agora">
    O segredo completo é exibido **exatamente uma vez**. Copie-o para o seu
    gerenciador de segredos — depois que você sair, apenas o prefixo continuará visível.
  </Step>
</Steps>

## Use-a

A chave está vinculada a esta organização, portanto as solicitações não precisam de ID da organização —
apenas do cabeçalho Bearer:

```bash
curl https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

A partir daqui, o [início rápido da API](/pt/quickstart) leva você à sua primeira
chamada em mais três solicitações.

## Faça a rotação e revogue

Crie uma nova chave, migre seus serviços e depois exclua a antiga
na mesma aba — a lista mostra o prefixo e o nome de cada chave para que você
possa diferenciá-las. Para automatizar a rotação, chame os
[endpoints de chaves de API para desenvolvedores](/api-reference/developer-api-keys) com um
token de sessão autenticada. Uma chave `sk_live_` não pode criar, listar nem revogar
chaves, portanto uma chave vazada não pode criar sua própria substituta. O mesmo vale para
membros, convites, configurações de pagamento e outros
[controles da conta](/api-reference/introduction#what-api-keys-cant-do).

<Note>
  As chaves de API de servidor são credenciais de máquina e estão isentas da
  política [**Exigir chaves de acesso**](/pt/guides/sso) da sua
  organização — essa configuração verifica logins humanos, não chaves `sk_live_...`.
  Por isso, fazer a rotação e revogar chaves prontamente aqui é seu principal
  controle sobre o acesso contínuo à API; se chaves de acesso forem exigidas,
  o painel de política de segurança mostra quantas chaves ativas estão atualmente
  isentas.
</Note>

<Tip>
  Peça ao copiloto no aplicativo para "criar uma chave de API", e ele guiará você
  por este fluxo, destacando cada controle em tempo real.
</Tip>

---

## Próximas etapas

<CardGroup cols={2}>
  <Card title="Início rápido da API" icon="terminal" href="/pt/quickstart">
    Agente, número, webhook, primeira chamada — quatro chamadas REST.
  </Card>
  <Card title="Referência de autenticação" icon="lock" href="/api-reference/introduction">
    Como funcionam a autenticação Bearer e a vinculação à organização.
  </Card>
</CardGroup>