API Pública de TimelinesAI
La API Pública le permitirá enviar mensajes automáticamente en TimelinesAI, en respuesta a un desencadenador/acción de los sistemas que utiliza actualmente, como los CRM.
Para comenzar a trabajar con la API Pública, debe acceder a la sección de «Integrations» (Integraciones) en TimelinesAI, que se puede encontrar en la barra lateral izquierda:
Una vez allí, podrá continuar y generar un token haciendo clic en el botón «Generate new token» (Generar nuevo token):
Ahora que ha generado su Token API, puede usarlo dentro de su sistema (CRM, sistemas de Soporte y/o Reclutamiento, etc.) para integrar TimelinesAI y enviar mensajes automatizados a través de WhatsApp.
Sin embargo, antes de continuar, siempre puede probar cómo funcionaría, con la ayuda de nuestra herramienta de prueba que tenemos disponible en la sección de «Public API» (API Pública) (haciendo clic en «Swagger»). Esta es una herramienta de pruebas que le permitirá enviar mensajes según el formato de solicitud que seleccione.
Antes de continuar con la herramienta de pruebas Swagger, recomendamos revisar la información sobre cómo funciona la API pública haciendo clic en el botón de «API Documentation» (Documentación de la API), dentro de la sección API Pública en TimelinesAI o, consultando este enlace (disponible solo en inglés): Documentación de la API pública de TimelinesAI
Algunas consideraciones antes de usar la herramienta de pruebas Swagger:
Habrá Utilización de Crédito (Llamadas API y/o Cuota de Envío Masivo)
Actualizar la página también actualizará los cambios que realice en ella.
Puede ir a la herramienta de pruebas haciendo clic en el enlace «Swagger» que tenemos disponible dentro de la sección API Pública en TimelinesAI o refiriéndose a este enlace: Herramienta de Pruebas - API Pública
Primero, deberá hacer clic en el botón de «Authorize», antes de usar la página. Al hacer clic en él, verá lo siguiente:
Aquí, asegúrese de pegar el Token API y luego haga clic en «Authorize» (Autorizar) y luego en «Close» (Cerrar). Esto le permitirá continuar y probar cómo funcionan los diferentes formatos.
Una vez que haya terminado, puede consultar cualquiera de los formatos de solicitud que tenemos disponibles en esta sección:
Asegúrese de seleccionar uno y luego haga clic en «Try it out» (Pruébelo). Esto le permitirá editar el cuerpo de la solicitud, agregando/reemplazando cada valor según corresponda. Puede consultar nuestra Documentación de la API para obtener más información sobre cómo funciona.
Por último, una vez que haya terminado de editar el cuerpo de la solicitud, puede continuar y hacer clic en «Execute» (Ejecutar), que enviará un mensaje siguiendo las instrucciones dentro del cuerpo de la solicitud.
1. Mensaje que indica que esto vino de la API Pública
2. Estas etiquetas también se crearon y agregaron a través de la API Pública
Puede descargar informes de registro («API Log Reports») en formato .txt que le informarán sobre las solicitudes de API y su estado. Puede obtener más información sobre las solicitudes y su estado, ya sea que hayan sido exitosas («Success») o no válidas («Invalid Parameters»), haciendo clic en el botón «Download log» (Descargar Registro), que le proporcionará un archivo que contiene las últimas 1,000 solicitudes dentro de su espacio de trabajo:
La API pública tiene dos saldos que limitan su uso:
Límite de Llamadas a la API: Es una asignación fija de 200,000 llamadas a la API por mes y se asigna a nivel de espacio de trabajo. El límite se restablece o se repone el primer día de cada nuevo ciclo de facturación y no se puede acumular.
Además, hay un límite de tasa de API, que permite hasta 50 solicitudes por minuto.
Estas llamadas a la API se utilizan para actualizar los detalles del chat en TimelinesAI (por ejemplo: asignación de chat, etiquetas, etc.). Si necesita más llamadas a la API, siempre puede comunicarse con nuestro soporte.
Cuota de Envío Masivo: La cuota será necesaria para enviar mensajes automáticos a través de la API pública. Sin embargo, si se envió un mensaje automático pero falló, se restaurarán las unidades de cuota que se usaron para ello.
Ésta también se asigna a nivel de espacio de trabajo y no se transfiere; no se puede acumular. Sin embargo, puede aumentar la cuota a través de su plan de suscripción.
Proporcionamos información detallada sobre esto aquí: Cuota de Envío Masivo: Descripción General
Recuerde, si necesita aumentar sus llamadas API y/o el límite de tasa de API, puede solicitarlo a través de nuestro soporte de chat o por correo electrónico a hello@timelines.ai.
Introducción:
Para comenzar a trabajar con la API Pública, debe acceder a la sección de «Integrations» (Integraciones) en TimelinesAI, que se puede encontrar en la barra lateral izquierda:
Una vez allí, podrá continuar y generar un token haciendo clic en el botón «Generate new token» (Generar nuevo token):
Token API: Cómo Utilizarlo
Ahora que ha generado su Token API, puede usarlo dentro de su sistema (CRM, sistemas de Soporte y/o Reclutamiento, etc.) para integrar TimelinesAI y enviar mensajes automatizados a través de WhatsApp.
Sin embargo, antes de continuar, siempre puede probar cómo funcionaría, con la ayuda de nuestra herramienta de prueba que tenemos disponible en la sección de «Public API» (API Pública) (haciendo clic en «Swagger»). Esta es una herramienta de pruebas que le permitirá enviar mensajes según el formato de solicitud que seleccione.
¿Cómo funciona la herramienta de pruebas Swagger?
Antes de continuar con la herramienta de pruebas Swagger, recomendamos revisar la información sobre cómo funciona la API pública haciendo clic en el botón de «API Documentation» (Documentación de la API), dentro de la sección API Pública en TimelinesAI o, consultando este enlace (disponible solo en inglés): Documentación de la API pública de TimelinesAI
Algunas consideraciones antes de usar la herramienta de pruebas Swagger:
Habrá Utilización de Crédito (Llamadas API y/o Cuota de Envío Masivo)
Actualizar la página también actualizará los cambios que realice en ella.
Puede ir a la herramienta de pruebas haciendo clic en el enlace «Swagger» que tenemos disponible dentro de la sección API Pública en TimelinesAI o refiriéndose a este enlace: Herramienta de Pruebas - API Pública
Primero, deberá hacer clic en el botón de «Authorize», antes de usar la página. Al hacer clic en él, verá lo siguiente:
Aquí, asegúrese de pegar el Token API y luego haga clic en «Authorize» (Autorizar) y luego en «Close» (Cerrar). Esto le permitirá continuar y probar cómo funcionan los diferentes formatos.
Una vez que haya terminado, puede consultar cualquiera de los formatos de solicitud que tenemos disponibles en esta sección:
Asegúrese de seleccionar uno y luego haga clic en «Try it out» (Pruébelo). Esto le permitirá editar el cuerpo de la solicitud, agregando/reemplazando cada valor según corresponda. Puede consultar nuestra Documentación de la API para obtener más información sobre cómo funciona.
Por último, una vez que haya terminado de editar el cuerpo de la solicitud, puede continuar y hacer clic en «Execute» (Ejecutar), que enviará un mensaje siguiendo las instrucciones dentro del cuerpo de la solicitud.
1. Mensaje que indica que esto vino de la API Pública
2. Estas etiquetas también se crearon y agregaron a través de la API Pública
Informes de Registro de la API
Puede descargar informes de registro («API Log Reports») en formato .txt que le informarán sobre las solicitudes de API y su estado. Puede obtener más información sobre las solicitudes y su estado, ya sea que hayan sido exitosas («Success») o no válidas («Invalid Parameters»), haciendo clic en el botón «Download log» (Descargar Registro), que le proporcionará un archivo que contiene las últimas 1,000 solicitudes dentro de su espacio de trabajo:
Límite de Utilización de Llamadas a la API Pública
La API pública tiene dos saldos que limitan su uso:
Límite de Llamadas a la API: Es una asignación fija de 200,000 llamadas a la API por mes y se asigna a nivel de espacio de trabajo. El límite se restablece o se repone el primer día de cada nuevo ciclo de facturación y no se puede acumular.
Además, hay un límite de tasa de API, que permite hasta 50 solicitudes por minuto.
Estas llamadas a la API se utilizan para actualizar los detalles del chat en TimelinesAI (por ejemplo: asignación de chat, etiquetas, etc.). Si necesita más llamadas a la API, siempre puede comunicarse con nuestro soporte.
Cuota de Envío Masivo: La cuota será necesaria para enviar mensajes automáticos a través de la API pública. Sin embargo, si se envió un mensaje automático pero falló, se restaurarán las unidades de cuota que se usaron para ello.
Ésta también se asigna a nivel de espacio de trabajo y no se transfiere; no se puede acumular. Sin embargo, puede aumentar la cuota a través de su plan de suscripción.
Proporcionamos información detallada sobre esto aquí: Cuota de Envío Masivo: Descripción General
Recuerde, si necesita aumentar sus llamadas API y/o el límite de tasa de API, puede solicitarlo a través de nuestro soporte de chat o por correo electrónico a hello@timelines.ai.
Actualizado el: 07/10/2024
¡Gracias!