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

# API do BluBash: autenticação e primeiros passos

> Tudo o que você precisa para integrar sua aplicação ao BluBash — autenticação, APIs disponíveis e dicas práticas para desenvolvedores.

A API do BluBash permite conectar sua aplicação diretamente à plataforma para enviar mensagens por meio de canais, gerenciar públicos de campanha e automatizar fluxos de comunicação com clientes. Todo acesso à API é autenticado com uma Workspace API Key obtida no painel de administração.

## APIs disponíveis

<CardGroup cols={2}>
  <Card title="Channels API" icon="message-circle" href="/pt-BR/developers/api/channels">
    Envie mensagens de texto, imagem, áudio, vídeo e documento por um canal de API configurado. As respostas são tratadas pelo agente de IA do seu workspace.
  </Card>

  <Card title="Campaigns API" icon="megaphone" href="/pt-BR/developers/api/campaigns">
    Adicione contatos a campanhas evergreen individualmente ou em massa, agende envios por contato, cancele mensagens em fila e inspecione o status das mensagens.
  </Card>
</CardGroup>

## Autenticação

Toda requisição à API do BluBash precisa incluir sua **Workspace API Key** no cabeçalho `X-API-Key`.

```http theme={null}
X-API-Key: your_workspace_api_key
Content-Type: application/json
```

<Warning>
  Mantenha sua chave de API em segredo. Nunca a exponha em código no cliente ou em repositórios públicos. Trate-a com o mesmo cuidado de uma senha.
</Warning>

### Obter sua chave de API

<Steps>
  <Step title="Abra o painel de administração do workspace">
    Faça login no BluBash e navegue até o seu workspace.
  </Step>

  <Step title="Vá até Configurações → API Keys">
    Encontre a seção API Keys dentro das configurações do workspace.
  </Step>

  <Step title="Gere ou copie uma chave">
    Crie uma nova chave ou copie uma existente para usar nas suas requisições.
  </Step>
</Steps>

## Idempotência

Para evitar mensagens duplicadas ao reenviar requisições com falha, inclua o cabeçalho opcional `X-Idempotency-Key` com um valor único por requisição.

```http theme={null}
X-Idempotency-Key: your_unique_idempotency_key
```

<Tip>
  Use um UUID ou um hash derivado do payload da requisição como chave de idempotência, para que a mesma operação lógica nunca seja processada duas vezes.
</Tip>

## Dicas para desenvolvedores

* Use sempre o mesmo valor de `contactIdentifier` para o mesmo contato, para evitar criar duplicatas.
* Implemente um tratamento adequado de erros para respostas HTTP de erro (`400`, `401`, `404`, `500`).
* Teste integrações em um ambiente de desenvolvimento antes de apontar tráfego para produção.
* Respeite os limites de taxa da API — configure sua lógica de retry com backoff exponencial.

## Suporte

Se precisar de ajuda, entre em contato com a equipe de suporte do BluBash em [suporte@blubash.io](mailto:suporte@blubash.io).