Skip to main content
Has creado un flujo de notificaciones de pedidos, un bot de atención o un módulo de mensajes para tu CRM. Ahora necesitas que el canal de WhatsApp siga funcionando. Las respuestas lentas y las desconexiones que pasan inadvertidas pueden consumir tu tiempo entre revisar sesiones, gestionar reintentos y ayudar a los clientes a iniciar sesión otra vez. WTO WA API está dirigida a desarrolladores que integran WhatsApp en sus propios productos. Su acceso basado en protocolo se centra en baja latencia, conexiones estables y menos desconexiones. Los endpoints REST, las consultas de estado y los webhooks conectan el canal de mensajes con tu lógica de negocio.
WTO WA API por protocolo: respuestas rápidas, conexiones estables y menos desconexiones

WTO WA API se centra en respuestas rápidas, conexiones estables y menos desconexiones para tus integraciones.

​
Empieza por tres prioridades de desarrollo

En un SaaS, CRM o herramienta de automatización, necesitas un flujo de mensajes que siga operativo y cuyo estado puedas observar. Un único envío correcto es solo el comienzo.

​
Acceso por protocolo: conecta la cuenta y llama a la API

El modo de conexión de WTO WA API descrito aquí utiliza una sesión de dispositivo vinculado de WhatsApp. Inicias sesión con un código QR o un código de vinculación por número de teléfono y utilizas la instancia para llamar a los endpoints. Este proceso difiere de la integración con WhatsApp Business Cloud API. Elige el modo de conexión que corresponda a tu proyecto. Tu aplicación conserva el control de la interfaz, las reglas de negocio y los datos de clientes, mientras la API ejecuta las operaciones de WhatsApp. Puedes usar el lenguaje de tu backend para realizar solicitudes HTTP, procesar respuestas y recibir eventos. Empieza por crear una instancia y conectarla con QR o código de vinculación. Usa una cuenta de prueba para el primer flujo.

​
Rapidez de respuesta: sigue el ritmo de tu negocio

Una consulta nueva, una actualización de pedido o una respuesta de atención puede activar una solicitud de mensaje. El tiempo de respuesta de la API influye en cuándo tu aplicación actualiza la interfaz, registra un resultado o programa el siguiente paso. La baja latencia es una prioridad de WTO WA API. Mide la duración de las solicitudes en las condiciones de red y concurrencia de tu proyecto para evaluar si encaja con tu flujo. Separa el tiempo de respuesta de la API del tiempo de entrega al destinatario. Una respuesta HTTP rápida no confirma la entrega; la red y el estado de la cuenta del destinatario también influyen. Si una solicitud agota el tiempo de espera, comprueba su resultado antes de reintentar para evitar mensajes duplicados.

​
Conexión estable: reduce las interrupciones del flujo

Menos desconexiones significan menos investigaciones sobre por qué una integración dejó de funcionar y menos interrupciones por nuevos inicios de sesión. WTO WA API prioriza la estabilidad y expone información de estado que tu aplicación puede utilizar. Consulta la conexión o suscríbete a CONNECTION_UPDATE mediante un webhook para actualizar indicadores, alertas o la lógica de envío. La guía de conexión utiliza estos estados:
  • open: la conexión está establecida y puedes continuar el flujo de envío.
  • connecting: la conexión se está estableciendo; espera y vuelve a consultar.
  • close: la sesión está desconectada y necesita revisión.
Recibir un código QR o de vinculación no significa que el inicio de sesión haya terminado. Confirma que instance.state sea open antes de enviar mensajes. Consulta la referencia del estado de conexión. La red, el estado de la cuenta y los cambios en la plataforma pueden afectar a la estabilidad. Observa la frecuencia, la duración y la recuperación de las desconexiones en tu propio uso para evaluar la experiencia.

​
API REST y webhooks: incorpora WhatsApp a tu producto

Ilustración conceptual de la conexión de la cuenta, las solicitudes y respuestas de la API y los eventos de webhook enviados a la aplicación

Flujo conceptual: conecta la cuenta, llama a la API y recibe eventos de webhook en tu aplicación.

Utiliza los endpoints REST para iniciar operaciones y los webhooks para recibir eventos en tu aplicación. Así puedes crear flujos de mensajes vinculados a los datos de tu negocio:
  • Notificaciones de SaaS: Activa una notificación en una etapa relevante para el cliente y muestra el resultado del procesamiento en el producto.
  • Integración con CRM: Asocia los mensajes con contactos, responsables y acciones de seguimiento.
  • Atención y aplicaciones de IA: Envía los eventos de mensajes recibidos a tu servicio y llama al endpoint de envío para responder.
Estos son escenarios que puedes implementar en tu aplicación. Empieza por enviar un mensaje de texto y configurar un webhook. Después, amplía el flujo a otros tipos de mensaje.

​
Implementa primero un flujo completo

  1. Crea una instancia. Utiliza credenciales autorizadas para ella y guárdalas en tu backend.
  2. Conecta la cuenta. Elige QR o código de vinculación y sigue las instrucciones para vincular el dispositivo.
  3. Confirma el estado. Espera a que sea open antes de enviar.
  4. Envía un mensaje de prueba. Sigue la documentación del endpoint y usa tu propio número de prueba. Comprueba tanto la respuesta de la API como la recepción del mensaje.
  5. Recibe eventos. Configura un webhook para los eventos de mensajes y los cambios de conexión que necesite tu aplicación.
Después de iniciar sesión, consulta la conexión con esta solicitud de solo lectura. Sustituye my-instance por el nombre de tu instancia y YOUR_API_KEY por una credencial autorizada:
Completa el flujo de conexión, consulta, envío y recepción de eventos antes de evaluar la latencia y las sesiones con carga real. Así puedes desarrollar sobre un flujo verificado, sin depender de pruebas manuales constantes para saber si la conexión sigue activa.

Empieza a integrar WTO WA API

Conecta tu primera instancia de WhatsApp mediante QR o código de vinculación y crea un canal de mensajes para tu SaaS, CRM o aplicación de automatización.