En este artículo explicamos cómo acceder a Botmaker API v2.0. Si deseas continuar utilizando la API v1.0, puedes consultar el ANEXO al final de este documento.

Lectura estimada: 11 minutos

Accediendo a Configuración > Integraciones > API de Botmaker (https://go.botmaker.com/#/api), podrás acceder a toda la documentación referida a la APIv2.0 de Botmaker haciendo clic en la pestaña Documentación.

En el menú que se encuentra a la izquierda de la pantalla, visualizarás todos los ENDPOINTS y sus respectivas secciones con la documentación relacionada.

Asimismo, haciendo clic en el botón Export, a la derecha de la pantalla, podrás descargar un archivo .json con el código de la API v2.0.

Para visualizar o gestionar tus credenciales, haz clic en la pestaña Credenciales en la pantalla principal de la API, como se muestra en la siguiente imagen:

Allí visualizarás el access token, el secret Id y el Refresh Token para poder integrar la API a tu proyecto. 

ANEXO API v1

Si deseas utilizar la API v1.0 desde la pantalla principal de la API v2.0 como se detalla arriba, haz clic en el botón Usar v1.0 para acceder a las credenciales de acceso correspondientes o revocarlas. También puedes seguir el proceso detallado en sección titulada Acceso, tal como se realizaba anteriormente a la implementación de la nueva versión (2.0).

Acceso

Sigue estos pasos luego de ingresar a la v1.0 de API:

1. Selecciona "Generar credenciales".

De esta forma se generan tus credenciales: Client Id, Secret Id, Access Token y Refresh Token.

2. Genera un token o usa el que ya se generó. En particular, es importante guardar el token de acceso.

3. Ingresa en Botmaker API docs (https://go.botmaker.com/apidocs/) y selecciona "Authorize":

4. Ingresa el token de acceso en el segundo campo de texto. Luego, haz click en Authorize.

Nota: Para evitar que los mensajes lleguen de manera asincrónica (o sea, que los horarios descargados por API no coincidan con los de la plataforma), debes tener en cuenta lo siguiente:

• La fecha debe estar en formato  ISO-8601 (por ejemplo: 2021-05-21T16:21:20.535Z)

Este formato incluye el timezone (zona horaria). En este caso, Z, indica que es GMT-0.

• Cuando se procesan grandes cantidades de mensajes, se prioriza el envío en paralelo y no el orden, por lo cual puede suceder que los envíos queden desordenados. Incluso si los has enviado en secuencia a WhatsApp, puede ser que ellos no puedan enviarlos en secuencia por problemas de conectividad impredecibles.
• Si deseas asegurar el envío en orden, puedes esperar la confirmación de entrega por webhook y luego enviar el siguiente mensaje. Otra alternativa es espaciar con una espera los mensajes de dicha conversación para asegurar que los mismos sean procesados en secuencia y no en paralelo.

Para obtener más detalles sobre la utilización de Botmaker API, consulta nuestro artículo relacionado ¿Cómo utilizar Botmaker API?

Recuerda visitar nuestro Centro de Ayuda para mayor información.

Escrito por: Equipo Botmaker

Actualizado: 11/09/2024