{"info":{"_postman_id":"673a78ba-edf4-4fbc-8aaa-b769ac8d19f6","name":"Waconecta | Client Services","description":"

🇪🇸 Descripción general

Esta documentación contiene la información necesaria para comenzar a utilizar la API de Waconecta.

La API de Waconecta proporciona endpoints para vincular sesiones, enviar mensajes y gestionar interacciones mediante WhatsApp.

🚀 Guía de iniciación

Necesita una clave de API válida, que será proporcionada por Engaged Tech.
\n
Las solicitudes deben realizarse únicamente a través de HTTPS. Las solicitudes HTTP serán redirigidas automáticamente con un código 301.
\n
Las respuestas de la API se entregan en formato JSON.
\n
Esta API tiene límites de uso y velocidad definidos.
\n

🔐 Autenticación

Waconecta API utiliza una clave de API para autenticar cada solicitud.

Incluya el header X-Api-Key con su clave en cada petición.
\n
Si la clave falta, está mal formada o no es válida, se devolverá un código HTTP 401 Unauthorized.
\n

⏱️ Límites de uso

Se permite un máximo de 30 solicitudes por minuto por clave de API.
\n
Dependiendo de su plan, también podrían aplicarse límites adicionales de uso.
\n
Al exceder estos límites, se devolverá un código HTTP 429 Too Many Requests.
\n

⚠️ Respuesta 503

Una respuesta HTTP 503 Service Unavailable indica un pico inesperado de tráfico. Generalmente, el servicio se restablece en menos de 5 minutos. Si la interrupción persiste o recibe otros errores 5XX, por favor contacte al soporte técnico.

🇺🇸 Overview

This documentation provides the necessary information to start using the Waconecta API.

The Waconecta API offers endpoints to manage sessions, send messages, and interact via WhatsApp.

🚀 Getting Started

You must use a valid API key, which will be provided by Engaged Tech.
\n
All requests must be made over HTTPS. Requests over HTTP will be redirected with a 301 status code.
\n
Responses are returned in JSON format.
\n
The API enforces rate and usage limits.
\n

🔐 Authentication

Waconecta API uses an API key for authentication.

Include the X-Api-Key header in every request.
\n
If the key is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response.
\n

⏱️ Rate & Usage Limits

The API allows up to 30 requests per minute per API key.
\n
Additional usage limits may apply depending on your subscription plan.
\n
If limits are exceeded, the API will return a 429 Too Many Requests status.
\n

⚠️ 503 Response

An HTTP 503 Service Unavailable response indicates a temporary traffic spike. The server is usually back online within 5 minutes. If the issue persists or other 5XX errors appear, please contact technical support.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"38039981","collectionId":"673a78ba-edf4-4fbc-8aaa-b769ac8d19f6","publishedId":"2sB2qi8xRe","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"6ee4ab"},"publishDate":"2025-06-04T18:18:54.000Z"},"item":[{"name":"Send Message","id":"4eeb5e3f-6773-45e6-a225-5808608fbe48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"number\": \"+59169657008\",\n \"message\": \"Tu código de verificación es *000000*. Por tu seguridad, no lo compartas\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base_middleware}}/api/v1/services/sendMessage","description":"

🇪🇸 Enviar mensaje

Este endpoint permite enviar un mensaje de texto a un número de WhatsApp previamente vinculado a través de la API.

URL: POST /api/v1/services/sendMessage
Base URL: https://waconecta-api.engaged.com.bo

📥 Cuerpo de la solicitud (JSON)

Incluya un objeto JSON con las siguientes propiedades:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Requerido	Descripción
`number`	integer	Sí	Número de WhatsApp al que se enviará el mensaje.
`message`	string	Sí	Texto del mensaje que se desea enviar.

🇺🇸 Send Message

This endpoint allows you to send a text message to a WhatsApp number previously linked via the API.

URL: POST /api/v1/services/sendMessage
Base URL: https://waconecta-api.engaged.com.bo

📥 Request Body (JSON)

Include a JSON object with the following required properties:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Required	Description
`number`	integer	Yes	WhatsApp number to which the message will be sent.
`message`	string	Yes	Text content of the message you want to send.

","urlObject":{"path":["api","v1","services","sendMessage"],"host":["{{url_base_middleware}}"],"query":[],"variable":[]}},"response":[{"id":"31d5abc5-d46e-459b-9363-89f3bd016b0f","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"number\":\"59169657008\",\r\n \"message\":\"Este es un mensaje de prueba\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base_middleware}}/api/v1/services/sendMessage"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"status\": 200,\n \"message\": \"data retrieved successfully\",\n \"data\": {\n \"key\": {\n \"remoteJid\": \"59169657008@s.whatsapp.net\",\n \"fromMe\": true,\n \"id\": \"BAE56A9BA190B10F\"\n },\n \"message\": {\n \"extendedTextMessage\": {\n \"text\": \"test\"\n }\n },\n \"messageTimestamp\": \"1721966309\",\n \"status\": \"PENDING\"\n }\n}"},{"id":"68d06a85-edd8-4580-a4cf-0e292d4eedc6","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"number\":\"59169657008\",\n \"message\":\"Este es un mensaje de prueba\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base_middleware}}/api/v1/services/sendMessage"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"status\": 401,\n \"message\": \"No autorizado\",\n \"data\": \"\"\n}"},{"id":"6204f608-93b9-4ac9-8612-a093e96d70b7","name":"Session has ended","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"number\":\"59169657008\",\n \"message\":\"Este es un mensaje de prueba\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base_middleware}}/api/v1/services/sendMessage"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"status\": 400,\n \"message\": \"Session has ended\",\n \"data\": \"\"\n}"},{"id":"bdb9b785-124a-4fe2-8c01-ff54252e059f","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"number\":\"5916965700e8\",\n \"message\":\"Este es un mensaje de prueba\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base_middleware}}/api/v1/services/sendMessage"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"status\": 400,\n \"message\": \"Invalid phone number\",\n \"data\": \"\"\n}"},{"id":"4c78d8dd-acf3-4e0d-8ea1-2c4c62bb77c5","name":"Too Many Requests","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"number\":\"59169657008\",\n \"message\":\"Este es un mensaje de prueba\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base_middleware}}/api/v1/services/sendMessage"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"status\": 429,\n \"message\": \"You can only send 30 messages per minute\",\n \"data\": \"\"\n}"}],"_postman_id":"4eeb5e3f-6773-45e6-a225-5808608fbe48"},{"name":"Get Qr Static Session","id":"02496f59-def5-4096-9ee2-07254c3a6bdd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"containerToken\":\"abY1289L/xPrKjL+3GTuf92YQptxLM2hrH9TpVKs4eRw=\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url_base_middleware}}/api/v1/services/getQrStaticSession","description":"

🇪🇸 📥 Cuerpo de la solicitud

Debe enviar un objeto JSON con el siguiente campo obligatorio:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Requerido	Descripción
`containerToken`	string	Sí	Token único del contenedor generado previamente para iniciar la sesión.

🇪🇸 🖼️ Respuesta esperada

La API devolverá una imagen codificada en base64 que representa un código QR.
El usuario debe escanear este código desde su aplicación móvil de WhatsApp para vincular una nueva sesión en Waconecta.

🇺🇸 📥 Request Body

Send a JSON object with the following required field:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Required	Description
`containerToken`	string	Yes	Unique container token generated earlier to initiate the session.

🇺🇸 🖼️ Expected Response

The API will return a base64-encoded image representing a QR code.
The user must scan this code using the WhatsApp mobile app to successfully link a new session in Waconecta.

\n","urlObject":{"path":["api","v1","services","getQrStaticSession"],"host":["{{url_base_middleware}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"02496f59-def5-4096-9ee2-07254c3a6bdd"}]}