Ir al contenido principal

Entender las API de Wati y sus límites de uso

Resumen

Al usar el CRM de Wati, obtienes acceso a un potente conjunto de APIs que te ayudan a conectar con tus clientes en WhatsApp. Ya sea que busques enviar mensajes, gestionar contactos o integrar Wati con tus propios sistemas, esta guía te explicará qué APIs están disponibles, los límites de uso según el plan, cuándo se restablecen dichos límites y qué hacer si necesitas más.

Instrucciones

¿Qué son las APIs de Wati?

Las APIs de Wati son herramientas que te permiten interactuar con WhatsApp a través de tu cuenta de Wati. Están diseñadas para ayudarte a:

  • Recuperar y enviar mensajes

  • Gestionar listas de contactos de clientes

  • Conectar con tus propias aplicaciones y sistemas

Puedes usar estas APIs para automatizar flujos de trabajo, realizar integraciones con CRMs o herramientas de soporte, y mejorar la comunicación con tus clientes.

Consejo: Para probar y explorar estas APIs, te recomendamos consultar la documentación de la API de Wati.

¿Cuáles son los límites de uso de la API en cada plan?

Cada plan de Wati cuenta con una cuota mensual diferente de llamadas a la API:

  • Plan Growth: 10,000 llamadas a la API

  • Plan Pro: 200,000 llamadas a la API

  • Plan Business: 20 millones de llamadas a la API

Estos límites ayudan a garantizar un uso justo y un rendimiento constante para todos los usuarios.

¿Cuándo se restablecen los límites de la API?

  • Los límites de uso de la API se restablecen el día 1 de cada mes.

  • Los límites no utilizados no se acumulan para el mes siguiente.

Nota: Si no utilizas toda tu cuota, las llamadas restantes caducarán al finalizar el mes.

¿Qué incluye el acceso a la API?

Los límites de uso mencionados anteriormente se aplican únicamente a las APIs de desarrollador, tales como aquellas para enviar mensajes, gestionar contactos y recuperar conversaciones.

Nota: Actualmente no existen límites de uso para las APIs de pago.

Esto significa que puedes utilizar libremente las APIs relacionadas con pagos sin preocuparte por los límites mensuales, mientras sigues gestionando el uso de tus APIs de desarrollador según tu plan.

¿Qué hago si necesito más llamadas a la API?

Si cuentas con el Plan Business, puedes solicitar límites más altos añadiendo un complemento (add-on) de cuota de API.

Nota: Solo los clientes en el Plan Business son elegibles para solicitar límites de API más altos. Si tienes el plan Growth o Pro, deberás actualizarte al plan Business para aumentar tus límites de API.

Para solicitar un complemento o discutir tus necesidades, contacta a nuestro equipo de soporte.

Diferencia entre límites de uso de la API y límites de tasa (rate limits) de la API

Los límites de tasa de la API (rate limits) y los límites de uso de la API controlan aspectos diferentes sobre cómo se pueden utilizar las APIs.

Los límites de tasa de la API restringen la frecuencia con la que puedes llamar a un endpoint de la API dentro de una ventana de tiempo específica.

Si envías demasiadas solicitudes en un periodo corto, el sistema bloqueará temporalmente las solicitudes adicionales y devolverá un error HTTP 429 (Too Many Requests).

A continuación, se muestran algunos límites de tasa a los que podrías enfrentarte, dependiendo de tu caso de uso:

Endpoint

Plan Growth

Plan Pro

Plan Business

/addContact, /getContacts

10 / 10 seg

10 / 10 seg

10 / 10 seg

/getMessages

10 / 10 seg

10 / 10 seg

10 / 10 seg

/sendTemplateMessage

30 / 10 seg

60 / 10 seg

100 / 10 seg

/sendTemplateMessages

30 / 10 seg

60 / 10 seg

100 / 10 seg

Notas:

  • No es necesario agregar contactos antes de enviar tu primer mensaje. Si el contacto no existe, se añade automáticamente a Wati cuando se envía el mensaje.

  • Recomendamos usar webhooks en lugar del endpoint /getMessages para recibir mensajes entrantes de forma más eficiente.

  • Si vas a enviar el mismo mensaje de plantilla a múltiples contactos, se recomienda utilizar el endpoint /sendTemplateMessages en lugar de /sendTemplateMessage.

  • El endpoint /sendTemplateMessages te permite incluir hasta 1000 contactos en una sola llamada a la API.

Por otro lado, los límites de uso de la API se refieren al número total de llamadas a la API según tu plan de suscripción. Los límites de uso determinan cuánto puedes usar la API en general, mientras que los límites de tasa determinan qué tan rápido puedes enviar solicitudes.

En términos simples:

  • Los límites de tasa controlan la velocidad de las solicitudes a la API (solicitudes por segundo o por ventana de tiempo).

  • Los límites de uso controlan el volumen total de uso de la API permitido bajo tu plan.

Preguntas frecuentes (FAQs)

Resumen de las APIs de Wati

1. ¿Para qué se usan las APIs de Wati?

Las APIs de Wati te permiten interactuar con WhatsApp a través de tu cuenta de Wati. Estas APIs se pueden utilizar para recuperar y enviar mensajes, gestionar listas de contactos de clientes y conectar Wati con tus propias aplicaciones o sistemas.

2. ¿Qué tareas se pueden automatizar usando las APIs de Wati?

Las APIs de Wati pueden usarse para automatizar flujos de trabajo, integrar Wati con CRMs o herramientas de soporte, enviar y recuperar mensajes, y gestionar contactos de clientes.

Límites de uso de la API

3. ¿Cuáles son los límites mensuales de uso de la API para cada plan de Wati?

Los límites mensuales de uso de la API dependen del plan de Wati:

  • Plan Growth: 10,000 llamadas a la API por mes

  • Plan Pro: 200,000 llamadas a la API por mes

  • Plan Business: 20 millones de llamadas a la API por mes

4. ¿Cuándo se restablecen los límites de uso de la API de Wati?

Los límites de uso de la API se restablecen el día 1 de cada mes. Cualquier llamada a la API no utilizada caduca al final del mes y no se acumula para el mes siguiente.

5. ¿Qué APIs están incluidas en los límites de uso de la API de Wati?

Los límites de uso se aplican únicamente a las APIs de desarrollador, tales como las APIs usadas para enviar mensajes, gestionar contactos y recuperar conversaciones.

6. ¿Existen límites de uso para las APIs de pago en Wati?

No. Actualmente no hay límites de uso para las APIs relacionadas con pagos, por lo que estas pueden utilizarse sin una cuota mensual.

Aumento de los límites de la API

7. ¿Cómo puedo solicitar más llamadas a la API en Wati?

Los clientes con el Plan Business pueden solicitar límites de API más altos añadiendo un complemento (add-on) de cuota de API. Los clientes con el plan Growth o Pro deben actualizar al Plan Business antes de poder solicitar límites más altos.

Límites de tasa de la API

8. ¿Cuál es la diferencia entre los límites de tasa de la API y los límites de uso de la API?

Los límites de tasa (rate limits) controlan la frecuencia con la que puedes llamar a un endpoint dentro de una ventana de tiempo específica, mientras que los límites de uso controlan el número total de llamadas permitidas bajo tu plan de suscripción. Los límites de tasa gestionan la velocidad de las solicitudes, mientras que los de uso gestionan el volumen global.

9. ¿Qué sucede si se excede un límite de tasa de la API?

Si se envían demasiadas solicitudes a la API en un periodo corto, el sistema bloqueará temporalmente las solicitudes adicionales y devolverá un error HTTP 429 (Too Many Requests).

10. ¿Cuáles son algunos ejemplos de límites de tasa de la API en Wati?

Ejemplos de límites de tasa incluyen:

  • /addContact y /getContacts: 10 solicitudes cada 10 segundos para todos los planes

  • /getMessages: 10 solicitudes cada 10 segundos para todos los planes

  • /sendTemplateMessage: 30 solicitudes cada 10 segundos para el Plan Growth, 60 solicitudes cada 10 segundos para el Plan Pro y 100 solicitudes cada 10 segundos para el Plan Business

  • /sendTemplateMessages: 30 solicitudes cada 10 segundos para el Plan Growth, 60 solicitudes cada 10 segundos para el Plan Pro y 100 solicitudes cada 10 segundos para el Plan Business

¿Ha quedado contestada tu pregunta?