Autenticação

​

Onde obter sua API Key

1. Acesse o Dashboard Botly
2. Acesse o Agente para o qual deseja criar uma API Key
3. No menu lateral, vá para a página API Keys
4. Clique em gerar uma nova chave e copie-a no momento em que for exibida — você não terá acesso a ela novamente depois disso

​

Como usar

​

Exemplo com cURL

curl -X POST "https://api.botly.com.br/api/v1/rest/messages/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY_AQUI" \
  -d '{
    "chatId": "1234567890",
    "message": "Olá!"
  }'

​

Exemplo com JavaScript (fetch)

const response = await fetch('https://api.botly.com.br/api/v1/rest/messages/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'SUA_API_KEY_AQUI'
  },
  body: JSON.stringify({
    chatId: '1234567890',
    message: 'Olá!'
  })
});

​

Boas práticas de segurança

• Não compartilhe sua API Key com terceiros
• Não commite a chave em código (use variáveis de ambiente)
• Rotacione a chave periodicamente ou em caso de suspeita de vazamento
• Em produção, nunca exponha a chave no frontend ou em apps móveis sem backend

​

Erros comuns