Espacios de trabajo
Una clave pertenece a un único espacio de trabajo. Qué implica esto para las aplicaciones multi-tenant y en qué se diferencia un portal de Bitrix24 de un espacio de trabajo independiente.
Un espacio de trabajo es el propietario de las conexiones de WhatsApp. Una API key se emite para un único espacio de trabajo, y todo lo que la clave puede ver o hacer queda limitado a él: no hay forma de consultar otro.
Una clave, un espacio de trabajo, muchas conexiones
Para una aplicación multi-tenant, esta es la estructura que le conviene:
- Una sola API key, no una por tenant. No genere una clave por cliente.
- Un
POST /connectionspor tenant, incluido el primero, cada uno con su propiaIdempotency-Keynueva. - Enrute los eventos entrantes por
connection_id: un cuid estable que aparece en cada respuesta REST y en cada payload de webhook. Asócielo a su propio registro de cliente; nosotros generamos el id y usted lo asocia. - Las conexiones nuevas se pueden usar de inmediato. La lista de conexiones de la clave se resuelve en vivo en cada solicitud, así que no hay nada que actualizar después de crear una.
Dos tipos de espacio de trabajo
Espacio de trabajo independiente
Se crea al registrarse en developers.wasync.app. La API es todo el producto: usted crea las conexiones por REST y cada conexión tiene su propia licencia.
Portal de Bitrix24
Se crea al instalar WASync en un portal de Bitrix24. Las conexiones las crea el administrador del portal dentro de WASync, y el acceso por API a un número es un complemento de pago.
La diferencia aparece en solo dos puntos, y conviene conocerlos antes de escribir código contra el tipo equivocado:
Crear conexiones. POST /connections solo está disponible en espacios independientes. En un portal de Bitrix24 responde 403 forbidden_portal_kind: el administrador del portal crea las conexiones en la interfaz de WASync. Todos los demás endpoints se comportan igual en ambos.
Qué hace accesible una conexión. En un espacio de trabajo independiente es la licencia propia de la conexión (prueba o de pago). En un portal de Bitrix24, la suscripción del portal paga el número en el CRM, y acceder a ese mismo número a través de la API requiere además el complemento de API, a $12 por número al mes. Sin él, la conexión simplemente no aparece en GET /connections.
Puesta en marcha
Con una API key no hay paso previo: la clave se emite directamente para su espacio de trabajo, por lo que POST /connections crea la primera conexión con la misma facilidad que la décima.
Una autorización OAuth es distinta por construcción: solo se emite sobre conexiones que ya existen, así que una integración solo con OAuth no puede crear la primera conexión de un espacio de trabajo. Por eso todas las guías de inicio rápido de aquí comienzan con una clave.