api etiviBot
Documentación de la API de Etivi
Bienvenido a la documentación oficial de la API de Etivi. Nuestra API RESTful proporciona un conjunto de endpoints que permiten la integración y automatización con WhatsApp, facilitando el desarrollo de soluciones personalizadas para tu negocio.
URL Base
https://api-whatsapp.wascript.com.br
Endpoints de Mensajería
/api/enviar-texto/{token}
Enviar un mensaje de texto
Envía un mensaje de texto simple a un número de teléfono específico.
Parámetros de Ruta
| Nombre | Tipo | Descripción |
|---|---|---|
token | string Requerido | Token de autenticación de tu cuenta de Etivi. |
Cuerpo de la Solicitud (JSON)
{
"phone": "5731512345678",
"message": "¡Hola! Este es un mensaje de prueba desde la API de Etivi."
}Respuestas
| Código | Descripción |
|---|---|
| 200 | Mensaje enviado con éxito. |
| 400 | Solicitud inválida o token faltante. |
| 404 | Token no registrado o inválido. |
| 500 | Error interno del servidor. |
| 501 | Error de conexión con el servicio de WhatsApp. |
/api/enviar-texto/{token}
Enviar texto vía URL
Envía un mensaje de texto simple usando parámetros en la URL (query string). Útil para integraciones rápidas o sistemas que no soportan POST.
Parámetros de Ruta
| Nombre | Tipo | Descripción |
|---|---|---|
token | string Requerido | Token de autenticación de tu cuenta de Etivi. |
Parámetros de Query
| Nombre | Tipo | Descripción |
|---|---|---|
phone | string Requerido | Número de teléfono de destino. |
message | string Requerido | Contenido del mensaje a enviar. |
Ejemplo de URL Completa
https://api-whatsapp.wascript.com.br/api/enviar-texto/TU_TOKEN?phone=5731512345678&message=Hola%20desde%20EtiviRespuestas
| Código | Descripción |
|---|---|
| 200 | Mensaje enviado con éxito. |
| 400 | Faltan parámetros requeridos en la URL. |
| 404 | Token no registrado o inválido. |
Envía una imagen a un número de teléfono. La imagen debe estar codificada en Base64.
Cuerpo de la Solicitud (JSON)
{
"phone": "5731512345678",
"base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQE...",
"message": "Aquí tienes la imagen solicitada."
}Respuestas
| 200 | Imagen enviada con éxito. |
| 402 | El tamaño del archivo Base64 excede el límite permitido. |
| 404 | Token no registrado o inválido. |
Envía un mensaje de audio a un número de teléfono. El archivo debe estar codificado en Base64.
Cuerpo de la Solicitud (JSON)
{
"phone": "5731512345678",
"base64": "data:audio/mp3;base64,SUQzBAAAAA..."
}Respuestas
| 200 | Audio enviado con éxito. |
| 402 | El tamaño del archivo Base64 excede el límite permitido. |
| 501 | Error de conexión. |
Envía un video a un número de teléfono. El archivo debe estar codificado en Base64.
Cuerpo de la Solicitud (JSON)
{
"phone": "531512345678",
"base64": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAA...",
"message": "Mira este video de demostración."
}Respuestas
| 200 | Video enviado con éxito. |
| 402 | El tamaño del archivo Base64 excede el límite permitido. |
| 500 | Error interno del servidor. |
Envía un documento (PDF, DOCX, etc.) a un número de teléfono. El archivo debe estar codificado en Base64.
Cuerpo de la Solicitud (JSON)
{
"phone": "531512345678",
"base64": "data:application/pdf;base64,JVBERi0xLjQKJc...",
"name": "catalogo-etivi.pdf"
}Respuestas
| 200 | Documento enviado con éxito. |
| 402 | El tamaño del archivo Base64 excede el límite permitido. |
| 501 | Error de conexión. |
Endpoints de Gestión de Etiquetas
Recupera todas las etiquetas (labels) configuradas en tu cuenta de WhatsApp.
Respuestas
| 200 | Etiquetas recuperadas con éxito. |
| 504 | Tiempo de espera agotado al recuperar las etiquetas. |
Permite añadir o eliminar etiquetas para uno o más números de teléfono.
Cuerpo de la Solicitud (JSON)
{
"phone": ["5731512345678", "5731587654321"],
"actions": [
{ "labelId": "1", "type": "add" },
{ "labelId": "2", "type": "remove" }
]
}Respuestas
| 200 | Etiquetas modificadas con éxito. |
| 406 | Chat no encontrado para uno de los números. |
| 422 | Error de validación del número de teléfono. |
Endpoints de Notas (CRM)
Crea una nueva nota asociada a un chat específico. Útil para registrar información de seguimiento en el CRM. Opcionalmente puede adjuntar un archivo.
Cuerpo de la Solicitud (JSON)
{
"userID": "5731512345678",
"text": "El cliente confirmó su interés en el plan premium. Enviar cotización.",
"base64": "data:application/pdf;base64,JVBERi0xLjQKJc..."
}Respuestas
| 200 | Nota creada con éxito. |
| 400 | Faltan campos requeridos (userID o text). |
| 500 | Error interno del servidor. |