Pular para o conteúdo principal
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

Channels API

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.

Campaigns API

Adicione contatos a campanhas evergreen individualmente ou em massa, agende envios por contato, cancele mensagens em fila e inspecione o status das mensagens.

​
Autenticação

Toda requisição à API do BluBash precisa incluir sua Workspace API Key no cabeçalho X-API-Key. 
X-API-Key: your_workspace_api_key
Content-Type: application/json
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.

​
Obter sua chave de API

1

Abra o painel de administração do workspace

Faça login no BluBash e navegue até o seu workspace.
2

Vá até Configurações → API Keys

Encontre a seção API Keys dentro das configurações do workspace.
3

Gere ou copie uma chave

Crie uma nova chave ou copie uma existente para usar nas suas requisições.

​
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. 
X-Idempotency-Key: your_unique_idempotency_key
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.

​
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.