Cree una cuenta y una clave
Dos formas de obtener una clave: desde Bitrix24, o en la consola de desarrolladores con un correo electrónico y una contraseña. Sin redirect URI, sin PKCE, sin pantalla de consentimiento.
Hay dos formas igualmente válidas de obtener una API key, según cómo utilice WASync.
Abra la aplicación en Bitrix24, vaya a Configuración → API y agentes y busque la tarjeta API keys. Ponga un nombre a la integración y haga clic en Crear clave.
Para crear una clave se necesita al menos una conexión con el complemento de
API activo (12 $ por número al mes). Sin él, el botón aparece deshabilitado
con el motivo, y el servidor responde 403 addon_required. La clave se muestra
una sola vez, allí mismo, con un botón Copiar, e incluye los scopes
estándar whatsapp.read whatsapp.send.
Las listas de IP permitidas, la configuración de webhooks y la gestión de varios portales desde una misma cuenta están en la consola de desarrolladores, no en esta tarjeta; la tarjeta incluye un enlace a ella.
La clave se muestra una sola vez: solo se guarda un hash de ella. Cópiela de inmediato en su entorno.
export WASYNC_API_KEY=wsk_live_…Envíela en cada solicitud:
Authorization: Bearer $WASYNC_API_KEYEsa es toda la configuración de autenticación. Sin redirect URI, sin PKCE, sin pantalla de consentimiento, sin renovación de tokens.
Scopes
Marque solo lo que la integración necesita: los scopes se definen por clave.
| Scope | Qué permite |
|---|---|
whatsapp.read | Listar conexiones y leer mensajes. |
whatsapp.send | Enviar mensajes y leer confirmaciones de lectura. |
whatsapp.events | Recibir webhooks y configurar adónde se envían. |
whatsapp.manage | Crear, inspeccionar, reiniciar, cerrar sesión y eliminar conexiones. |
Los scopes y la lista de conexiones accesibles se resuelven en vivo en cada solicitud, de modo que revocar una clave o reducir su alcance surte efecto en la siguiente llamada: no hay nada en caché ni nada que renovar. Los detalles, y lo que le cuesta cada scope si se filtra, están en Scopes.
No puede quedarse sin acceso
La lista de IP permitidas, opcional, se aplica solo a las llamadas a la API. La página donde la edita se autentica con su cuenta, no con la clave, por lo que sigue accesible desde cualquier dirección. Consulte Lista de IP permitidas.
Cuánto cuesta una conexión
Cada número de WhatsApp necesita una licencia activa para enviar y recibir. Un
número nuevo comienza con una prueba gratuita de 7 días; después cuesta 19 $
por número al mes si es un número qr (WAPP) o 29 $ por número al mes si es un
número cloud_api (WABA), en USD. En un portal de Bitrix24, el acceso a la API
para un número es un complemento aparte de 12 $ por número al mes.
Licencias y prueba ofrece el panorama
completo.