API REST Universal y Platform Apps: autenticación, tokens y endpoints principales

La API REST Universal de Waclis Inbox permite a desarrolladores integrar la plataforma con sistemas de gestión empresarial, CRMs y aplicaciones a medida, facilitando la creación de conversaciones, envío programático de mensajes y sincronización de contactos.

Autenticación y modelos de acceso

Toda petición a la API REST de Waclis Inbox debe autenticarse enviando el token de acceso en las cabeceras HTTP:

api_access_token: TU_TOKEN_DE_ACCESO

o alternativamente mediante cabecera estándar:

Authorization: Bearer TU_TOKEN_DE_ACCESO

Las credenciales de acceso pueden originarse mediante tokens de usuario personal para scripts directos o mediante Platform Apps empresariales aprovisionadas para integraciones del ecosistema.

Generación de credenciales y uso de endpoints

Paso 1: Obtener un token de acceso personal

1. Haz clic sobre tu avatar en el menú de usuario y selecciona Ajustes de perfil.
2. Desplázate hasta la sección Tokens de acceso de API.
3. Haz clic en el botón Copiar token de acceso para autenticar tus peticiones HTTP.

Paso 2: Invocar endpoints principales

1. Configura la cabecera HTTP api_access_token o Authorization Bearer en tus peticiones REST.
2. Ejecuta una petición GET al endpoint de perfil /api/v1/profile para comprobar la conexión.
3. Envía peticiones POST al endpoint de contactos para crear o sincronizar registros comerciales.
4. Utiliza el endpoint de mensajes para despachar comunicaciones programáticas desde aplicaciones autorizadas.

Comprobación

Ejecuta una petición GET al endpoint de perfil /api/v1/profile incluyendo tu api_access_token y confirma que la respuesta HTTP retorne código 200 OK con los datos de tu cuenta.

Límites y buenas prácticas

El aprovisionamiento de Platform Apps a nivel de infraestructura y permisos avanzados es gestionado por la administración de la plataforma. Para integraciones departamentales habituales, utiliza tokens personales de agentes autorizados o bots dedicados.

Artículos relacionados

• Webhooks salientes en tiempo real y verificación de firma de seguridad HMAC-SHA256
• Dashboard Apps: incrustación de portales web en iFrames contextuales del chat