Resumen
Un token de API permite que sistemas externos, como plataformas de gestión de relaciones con los clientes (CRM) o aplicaciones personalizadas, se conecten de forma segura con Wati y accedan a sus API. Esta guía explica cómo generar un token de API en Wati, elegir los permisos correctos y almacenar el token de forma segura para su uso futuro.
Instrucciones
Siga los pasos a continuación para generar un nuevo token de API en su cuenta de Wati.
Paso 1: Inicie sesión en su cuenta de Wati
Inicie sesión en su cuenta de Wati.
Paso 2: Vaya a la página de Tokens de API
Vaya a Connector > API Tokens
Paso 3: Genere un nuevo token de API
En la página de API Tokens, haga clic en Generate new token (Generar nuevo token).
Ingrese un nombre de token para identificarlo.
Paso 4: Seleccione los permisos necesarios (ámbitos)
Elija los permisos que necesita su integración. Estos permisos se denominan ámbitos (scopes) y definen a qué puede acceder el token.
Ejemplos de ámbitos de uso común incluyen:
contacts:read— Permite leer los datos de contactocontacts:write— Permite crear o actualizar contactosmessagetemplate:read— Permite leer la información de las plantillas de mensajes
Seleccione solo los ámbitos requeridos para su integración para mejorar la seguridad.
Paso 5: Establezca una fecha de caducidad (opcional)
Puede establecer una fecha de caducidad para el token. Esto ayuda a reducir los riesgos de seguridad al limitar el tiempo durante el cual el token permanece activo.
Para una mayor seguridad, se recomienda rotar los tokens de API cada 6 meses.
Paso 6: Copie y almacene el token de forma segura
Después de generar el token:
Copie el token inmediatamente.
Almacénelo de forma segura en su administrador de contraseñas o entorno seguro.
Importante: El token se muestra solo una vez en el momento de la generación. Si lo pierde, deberá generar uno nuevo.
Notas:
La opción Create New Token (Crear nuevo token) elimina las dependencias a nivel de usuario, lo que significa que el token no depende de una cuenta de usuario específica.
El token permanecerá activo hasta que:
Alcance la fecha de caducidad, o
Sea actualizado o revocado manualmente.
Ámbitos de API requeridos: Los endpoints de la API V3 requieren los ámbitos V3 correspondientes. Por ejemplo:
contactsv3:*,conversationsv3:*ymessagetemplatev3:write.
Requisitos de ámbitos: Cada endpoint acepta cualquiera de los ámbitos listados para él. Asegúrese de que su token de API tenga al menos uno de los ámbitos requeridos. También puede aparecer un error
403 Forbiddensi su rol de usuario o plan de suscripción no cuenta con los permisos necesarios.
Nomenclatura de ámbitos: Los ámbitos de la API de Wati utilizan el prefijo
wati_. Incluya este prefijo al configurar o hacer referencia a los ámbitos requeridos.
Mantener sus tokens de API seguros ayuda a proteger sus integraciones y evita el acceso no autorizado a su cuenta de Wati.
Preguntas frecuentes (FAQs)
Conceptos básicos y permisos de los tokens de API
1. ¿Qué es un token de API en Wati?
Un token de API permite que sistemas externos, como plataformas de gestión de relaciones con los clientes (CRM) o aplicaciones personalizadas, se conecten de forma segura con Wati y accedan a sus API.
2. ¿Qué son los ámbitos (scopes) de los tokens de API en Wati?
Los ámbitos de los tokens de API son permisos que definen a qué recursos y operaciones de Wati puede acceder una integración. Por ejemplo, los ámbitos pueden permitir que una integración lea datos de contacto, cree o actualice contactos, o lea información de plantillas de mensajes.
3. ¿Qué ámbitos de API se requieren para los endpoints de la API V3 de Wati?
Los endpoints de la API V3 de Wati requieren los ámbitos V3 correspondientes. Algunos ejemplos son contactsv3:*, conversationsv3:* y messagetemplatev3:write. Cada endpoint de API acepta cualquiera de los ámbitos enumerados como necesarios para ese endpoint. Su token de API debe incluir al menos uno de esos ámbitos requeridos.
4. ¿Por qué recibo un error 403 Forbidden al usar un token de API de Wati?
Un error 403 Forbidden puede ocurrir si su token de API no incluye al menos uno de los ámbitos requeridos para el endpoint de la API. También puede ocurrir si su rol de usuario o su plan de suscripción no tienen los permisos necesarios.
Caducidad y seguridad de los tokens de API
5. ¿Un token de API de Wati caduca automáticamente?
Un token de API de Wati permanece activo hasta que alcanza su fecha de caducidad configurada o se actualiza o revoca manualmente. Establecer una fecha de caducidad es opcional y ayuda a limitar el tiempo que el token permanece activo.
6. ¿Puedo recuperar mi token de API de Wati después de generarlo?
No. Wati muestra un token de API solo una vez, inmediatamente después de generarlo. Copie y almacene el token de forma segura cuando se genere. Si pierde el token, debe generar uno nuevo. Wati recomienda rotar los tokens de API cada 6 meses para una mayor seguridad.
Did this answer your question?