Créer un compte et une clé
Deux façons d'obtenir une clé — depuis Bitrix24, ou sur la console développeur avec un e-mail et un mot de passe. Pas d'URI de redirection, pas de PKCE, pas d'écran de consentement.
Il existe deux façons tout aussi valables d'obtenir une API key, selon la manière dont vous utilisez WASync.
Ouvrez l'application dans Bitrix24, allez dans Settings → API & Agents, puis repérez la carte API keys. Donnez un nom à l'intégration et cliquez sur Create key.
Pour créer une clé, il faut au moins une connexion avec le API add-on actif
(12 $ par numéro et par mois). Sans cela, le bouton est désactivé et la raison
est indiquée ; le serveur répond 403 addon_required. La clé s'affiche une
seule fois, à cet endroit, avec un bouton Copy, et porte les scopes
standard whatsapp.read whatsapp.send.
Les listes d'adresses IP autorisées, la configuration des webhooks et la gestion de plusieurs portails depuis un même compte se trouvent dans la console développeur, pas dans cette carte — la carte y renvoie.
La clé s'affiche une seule fois — seul son hachage est conservé. Copiez-la tout de suite dans votre environnement.
export WASYNC_API_KEY=wsk_live_…Envoyez-la à chaque requête :
Authorization: Bearer $WASYNC_API_KEYC'est toute la configuration d'authentification. Pas d'URI de redirection, pas de PKCE, pas d'écran de consentement, pas de renouvellement de jeton.
Scopes
Cochez uniquement ce dont l'intégration a besoin — les scopes se définissent par clé.
| Scope | Ce qu'il autorise |
|---|---|
whatsapp.read | Lister les connexions et lire les messages. |
whatsapp.send | Envoyer des messages et lire les accusés de réception. |
whatsapp.events | Recevoir des webhooks et configurer leur destination. |
whatsapp.manage | Créer, inspecter, redémarrer, déconnecter et supprimer des connexions. |
Les scopes et la liste des connexions accessibles sont résolus en direct à chaque requête. Révoquer une clé ou restreindre ses droits prend donc effet dès l'appel suivant : rien n'est mis en cache et il n'y a rien à rafraîchir. Les détails, et ce que chaque scope vous coûterait en cas de fuite, se trouvent sous Scopes.
Vous ne pouvez pas vous enfermer dehors
La liste d'adresses IP autorisées, facultative, ne s'applique qu'aux appels API. La page où vous la modifiez est authentifiée par votre compte, pas par la clé : elle reste donc accessible depuis n'importe quelle adresse. Voir Liste d'adresses IP autorisées.
Ce que coûte une connexion
Chaque numéro WhatsApp a besoin d'une licence active pour envoyer et recevoir.
Un nouveau numéro démarre avec un essai gratuit de 7 jours, puis coûte 19 $
par numéro et par mois pour un numéro qr (WAPP) ou 29 $ par numéro et par mois
pour un numéro cloud_api (WABA), en USD. Sur un portail Bitrix24, l'accès API
à un numéro est un add-on distinct à 12 $ par numéro et par mois.
Licences et essai donne le détail complet.