INTEGRA MBAETEKO CON TU SISTEMA USANDO NUESTRA API

Conectá tus aplicaciones o sistemas internos con la API de Mbaeteko y automatizá la comunicación por WhatsApp con tus clientes.

La API de Mbaeteko permite a desarrolladores y programadores integrar fácilmente el envío y recepción de mensajes de WhatsApp dentro de sus propios sistemas. Podés automatizar notificaciones, crear flujos de comunicación, registrar leads en tu CRM o generar reportes inteligentes con nuestro servidor LLM. Ideal para proyectos SaaS, ERPs, CRMs o cualquier plataforma que necesite conectarse con clientes de forma ágil y eficiente.

Manual de uso de la API

Enviá mensajes de texto e imágenes por WhatsApp usando la API de Mbaeteko.

Esta guía rápida muestra endpoints, parámetros, ejemplos en PHP/JS y respuestas esperadas.

1. Endpoint de la API

La URL principal para enviar mensajes es:

https://mbaeteko.com/api/enviar

2. Parámetros

Se pueden enviar por GET o POST. A continuación la tabla con los parámetros:

Parámetro	Descripción	Obligatorio
`token`	Token de autenticación de tu usuario / sucursal.	Sí
`celular`	Número de WhatsApp del destinatario (ej: `595976815431`).	Sí
`mensaje`	Texto que deseas enviar.	Sí
`imagen`	URL pública de la imagen que se quiere enviar (opcional).	No

3. Ejemplos de uso

3.1 Enviar solo texto

https://mbaeteko.com/api/enviar?token=23423&celular=595976815431&mensaje=Hola

3.2 Enviar mensaje con imagen

https://mbaeteko.com/api/enviar?token=23423&celular=595976815431&mensaje=Hola&imagen=https://mbaeteko.com/login/dist/images/logo-horizontal.png

3.3 Ejemplo en PHP

<?php
$token   = "23423";
$celular = "595976815431";
$mensaje = "Hola";
$imagen  = "https://mbaeteko.com/login/dist/images/logo-horizontal.png";

$url = "https://mbaeteko.com/api/enviar?token=$token&celular=$celular&mensaje=".urlencode($mensaje)."&imagen=".urlencode($imagen);

$response = file_get_contents($url);
$data = json_decode($response, true);

if (isset($data['status']) && $data['status'] === 'ok') {
    echo "Mensaje enviado correctamente!";
} else {
    $error = $data['msg'] ?? 'Error desconocido';
    echo "Error: ".$error;
}
?>

3.4 Ejemplo en JavaScript (fetch)

fetch("https://mbaeteko.com/api/enviar?token=23423&celular=595976815431&mensaje=Hola&imagen=https://mbaeteko.com/login/dist/images/logo-horizontal.png")
  .then(response => response.json())
  .then(data => {
    if (data.status === "ok") {
      console.log("Mensaje enviado!");
    } else {
      console.error("Error:", data.msg);
    }
  })
  .catch(err => console.error("Error de red:", err));

4. Respuestas de la API

La API devuelve siempre un JSON con al menos el campo status:

{
  "status": "ok",
  "msg": "Mensaje enviado",
  "id": "123456" 
}
-- o --
{
  "status": "error",
  "msg": "Token inválido o sin créditos"
}

Interpretación rápida:

status: ok ? Mensaje enviado correctamente.
status: error ? Ocurrió un error (falta de parámetros, token inválido, sin créditos, imagen no disponible, etc.).

5. Notas importantes

El token debe estar activo y tener créditos (freepy o equivalente según tu plan).
El número de celular debe enviarse en formato numérico sin signos (+, -, espacios).
Si envías una imagen, la URL debe ser accesible públicamente vía http o https.
Manejá los errores de la API (reintentos limitados / logging) para evitar pérdida de mensajes.

Sugerencia de buenas prácticas:

Validá localmente los parámetros antes de llamar la API (token, celular y mensaje no vacíos).
Implementá manejo de errores y reintentos con backoff en caso de fallos temporales.
Guardá el id de cada envío (cuando la API lo devuelva) para trazabilidad.
Si vas a enviar imágenes, verificá el Content-Type y tamaño para evitar fallos al remitente.