Resumen

Para conectar su aplicación o integración con Wati, necesita un token de API y la URL del punto de conexión (endpoint) de API correcta. Esta guía explica cómo generar un nuevo token de API, configurar su caducidad y permisos, y encontrar la URL de punto de conexión correcta para las API v1, v2 y v3.

Instrucciones

Generar un token de API en Wati

Siga estos pasos para generar un nuevo token de API:

  • Inicie sesión en su cuenta de Wati.

  • Vaya a Connectors (Conectores) > API Tokens (Tokens de API).

  • Haga clic en Generate new token (Generar nuevo token).

  • Ingrese un nombre para su token, si se le solicita.

  • Establezca la duración de caducidad del token según sus requisitos.

  • En Scope (Alcance), seleccione los permisos requeridos para su integración. Seleccione Select all (Seleccionar todo) si su integración necesita todos los permisos disponibles.

  • Haga clic en la opción de generar y copie el token.

Importante

  • Su token de API se muestra solo una vez cuando lo genera. Cópielo y guárdelo de forma segura antes de cerrar la ventana. Si pierde el token, debe generar uno nuevo y actualizar su integración.

  • El antiguo Bearer Token (token de portador) disponible anteriormente en la página API Docs caducaba cuando se cambiaba la contraseña del usuario asociado. Este comportamiento se aplica solo a los tokens heredados y no a los nuevos tokens de API generados. Los nuevos tokens de API permanecen válidos hasta su fecha de caducidad configurada o hasta que se roten manualmente.

Encuentre su punto de conexión de API (API Endpoint)

Puede encontrar su punto de conexión de API en la misma página que los tokens.

Wati utiliza la siguiente URL base (host) para las solicitudes de API:

https://live-mt-server.wati.io

El formato de la URL del punto de conexión depende de la versión de API que esté utilizando.

Para las API v1 y v2

Incluya su ID de inquilino (tenant ID) de Wati inmediatamente después de la URL base, seguido de la ruta de la API.

https://live-mt-server.wati.io/{tenantId}/api/v1/...

Reemplace {tenantId} con su ID de inquilino de Wati.

Para las API v3

No incluya su ID de inquilino en la URL. Utilice la ruta de la API v3 directamente después de la URL base.

https://live-mt-server.wati.io/api/ext/v3/...

Importante: No añada /{tenantId}/ a las URLs de puntos de conexión de la API v3. Esto resultará en una URL de punto de conexión incorrecta.

Notas importantes sobre los tokens de API

  • Caducidad del token: Su token de API permanece válido hasta su fecha de caducidad configurada o hasta que se rote manualmente.

  • Seguridad del token: Mantenga su token de API confidencial. No lo comparta públicamente ni lo exponga en código del lado del cliente.

  • Permisos del token: Seleccione los permisos que necesita su integración al generar el token.

  • Reemplazo de token: Si genera un token de reemplazo, actualice su integración para utilizar el nuevo token.

  • Legacy Bearer Token: El antiguo Bearer Token disponible anteriormente en API Docs ya no está disponible. Debe generar un nuevo token de API en Connectors > API Tokens.

Wati introdujo el nuevo proceso de generación de tokens para mejorar la seguridad. Esto le permite configurar la duración de caducidad y los permisos del token, lo cual no estaba disponible con el antiguo Bearer Token.

Para obtener más información sobre los puntos de conexión y operaciones de API disponibles, consulte la documentación de la API de Wati.

Preguntas frecuentes (FAQs)

Generación y autenticación de tokens de API

1. ¿Dónde puedo generar un token de API en Wati?

Puede generar un token de API iniciando sesión en su cuenta de Wati y navegando a Connectors > API Tokens. Haga clic en Generate new token, configure la duración de caducidad y los permisos del token, y genere el token.

2. ¿Sigue estando disponible el antiguo Bearer Token en API Docs?

No. El antiguo Bearer Token disponible anteriormente en API Docs ya no está disponible. Debe generar un nuevo token de API en Connectors > API Tokens para autenticar sus solicitudes de API.

3. ¿Por qué Wati requiere generar un nuevo token de API?

Wati introdujo el nuevo proceso de generación de tokens de API para mejorar la seguridad. Esto le permite configurar la duración de caducidad del token y seleccionar los permisos otorgados al mismo.

Gestión de tokens de API

4. ¿Puedo recuperar un token de API generado anteriormente o configurar su duración de caducidad?

No. No puede recuperar un token de API generado anteriormente porque Wati muestra el token solo una vez cuando se crea.

Puede configurar la duración de caducidad al generar un nuevo token de API. El token permanece válido hasta que caduque o se rote manualmente.

Si pierde su token de API, genere uno nuevo en Connectors > API Tokens y actualice su integración para utilizarlo.

URLs de puntos de conexión de API

5. ¿Cuándo debo incluir mi ID de inquilino (tenant ID) en una URL de punto de conexión de la API de Wati?

Incluya su ID de inquilino inmediatamente después de la URL base cuando utilice los puntos de conexión de las API v1 y v2 de Wati.

No incluya su ID de inquilino en las URLs de puntos de conexión de la API v3, las cuales utilizan la ruta /api/ext/v3/.

Did this answer your question?