Crie uma conta e uma chave
Duas formas de obter uma chave — dentro do Bitrix24 ou no console de desenvolvedores, com e-mail e senha. Sem redirect URI, sem PKCE, sem tela de consentimento.
Há duas formas igualmente válidas de obter uma API key, dependendo de como você usa o WASync.
Abra o aplicativo no Bitrix24, vá em Configurações → API e Agentes e encontre o cartão API keys. Dê um nome à integração e clique em Criar chave.
Para criar uma chave, é preciso ter pelo menos uma conexão com o add-on de API
ativo (US$ 12 por número por mês). Sem isso, o botão fica desativado e mostra o
motivo, e o servidor responde 403 addon_required. A chave é exibida uma única
vez, ali mesmo, com um botão Copiar, e traz os escopos padrão
whatsapp.read whatsapp.send.
Listas de IPs permitidos, configuração de webhooks e o gerenciamento de vários portais a partir de uma só conta ficam no console de desenvolvedores, não neste cartão — o cartão tem um link para ele.
A chave é exibida uma única vez — só um hash dela é armazenado. Copie-a para o seu ambiente imediatamente.
export WASYNC_API_KEY=wsk_live_…Envie-a em todas as requisições:
Authorization: Bearer $WASYNC_API_KEYEssa é toda a configuração de autenticação. Sem redirect URI, sem PKCE, sem tela de consentimento, sem renovação de token.
Escopos
Marque apenas o que a integração precisa — os escopos são definidos por chave.
| Scope | What it allows |
|---|---|
whatsapp.read | Lista conexões e lê mensagens. |
whatsapp.send | Envia mensagens e lê confirmações de leitura. |
whatsapp.events | Recebe webhooks e configura para onde eles vão. |
whatsapp.manage | Cria, inspeciona, reinicia, desconecta e exclui conexões. |
Os escopos e a lista de conexões acessíveis são resolvidos em tempo real a cada requisição. Por isso, revogar uma chave ou restringi-la vale já na próxima chamada — não há nada em cache e nada para renovar. Os detalhes, e o que cada escopo custa a você se vazar, estão em Escopos.
Você não corre o risco de se bloquear
A lista de IPs permitidos, opcional, vale apenas para chamadas de API. A página onde você a edita é autenticada pela sua conta, não pela chave, então continua acessível de qualquer endereço. Veja Lista de IPs permitidos.
Quanto custa uma conexão
Cada número de WhatsApp precisa de uma licença ativa para enviar e receber. Um
número novo começa com 7 dias de teste grátis; depois, são US$ 19 por número
por mês para um número qr (WAPP) ou US$ 29 por número por mês para um número
cloud_api (WABA), em dólares americanos. Em um portal Bitrix24, o acesso de API
a um número é um add-on separado, de US$ 12 por número por mês.
Licenças e teste traz o quadro completo.