Início
Autentique-se na API do Bandmaster e faça a primeira chamada.
Como a integração funciona
O Bandmaster tem duas portas, e cada uma tem seu host:
| O que você faz | Host |
|---|---|
| Gerenciar: login, número, templates, chaves | admin.2bebandmaster.com.br |
| Enviar mensagens | message.2bebandmaster.com.br |
E o que chega até você não é buscado por chamada: o Bandmaster entrega na sua URL, via webhook — mensagens recebidas, status de entrega e falhas.
Três passos até a primeira mensagem
- Autentique-se e guarde o token.
- Aponte o webhook para a sua URL.
- Crie um template e envie.
Quickstart
O primeiro passo é o login: você troca usuário e senha por um token JWT. Todas as
demais chamadas levam esse token no header authorization, e o identifier do
número que você opera.
login
/authentication›headers
- content-type:
- application/json
curl -X POST https://admin.2bebandmaster.com.br/authentication \
-H "content-type: application/json" \
-d '{"username":"seu-usuario","password":"sua-senha"}'{
"user_id": "665f1c2e8a1b4a0012ab34cd",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"role": "user"
}Com o token na mão, confira os dados do seu número:
dados do número
/phones/info›headers
- authorization:
- Bearer <token>
- identifier:
- <identifier-do-numero>
curl https://admin.2bebandmaster.com.br/phones/info \
-H "authorization: Bearer $TOKEN" \
-H "identifier: $IDENTIFIER"{
"number": "5511999999999",
"identifier": "seu-identifier",
"webhook": "https://sua-aplicacao.com.br/webhooks/bandmaster",
"description": "Atendimento",
"current_limit": "TIER_1K",
"current_quality_rating": "GREEN"
}Por onde seguir
Autenticação
Login, token JWT e o header identifier.
Gerenciar o número
URL de webhook, perfil e a chave de assinatura.
Enviar mensagens
Todos os tipos: texto, mídia, template, interativas e mais.
Enviar templates
Criar template, subir a mídia do header e acompanhar a aprovação.
Receber webhooks
Os payloads que chegam na sua URL e como verificar a assinatura.