Documentación de MiAPI WhatsApp VIP

Esta API propia permite conectar múltiples números de WhatsApp (instancias por device_id) para VetIA y cualquiera de tus sistemas.

Ofrece dos modos de consumo equivalentes sobre el mismo núcleo:

Autenticación y Reglas de Validación

Cada cliente o sistema recibe un token único desde el Panel Admin. Podés enviarlo de cualquiera de estas formas:

En cada petición el Gateway valida: token válido, estado activo, fecha de vencimiento, cupo de instancias, whitelist de IP/CIDR y whitelist de dominio (Origin / Referer / X-Client-Domain) si están configuradas.

Gestión de Cuenta e Instancias

Acción Legacy (api.php)Equivalente REST v1Parámetros principales
GET ?acao=meus_dadosGET /v1/accounttoken
GET ?acao=minhas_instanciasGET /v1/instancestoken
POST ?acao=criar_instanciaPOST /v1/instancesapelido, webhook_url (opc), cron_url (opc)
GET ?acao=login_instanciaGET /v1/instances/{device_id}/qrdevice_id
GET ?acao=login_com_codigoPOST /v1/instances/{device_id}/pair-codedevice_id, telefone
GET ?acao=status_instanciaGET /v1/instances/{device_id}/statusdevice_id
POST ?acao=atualizar_instanciaPATCH /v1/instances/{device_id}device_id, apelido, webhook_url
POST ?acao=logout_instanciaPOST /v1/instances/{device_id}/logoutdevice_id
POST ?acao=remover_instanciaDELETE /v1/instances/{device_id}device_id

Ejemplo: Crear instancia y obtener QR (PHP)

$ch = curl_init('https://api.nubetech.online/api.php?acao=criar_instancia');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'token'       => 'TU_TOKEN',
        'apelido'     => 'Recepción VetIA',
        'webhook_url' => 'https://tusistema.com/webhook_whatsapp.php',
    ]),
]);
$resp = json_decode(curl_exec($ch), true);

Mensajería, Multimedia y Encuestas

Acción Legacy (api.php)Equivalente REST v1Campos
POST ?acao=enviar_mensagemPOST /v1/messages/textdevice_id, telefone, mensagem
POST ?acao=enviar_midiaPOST /v1/messages/mediadevice_id, telefone, tipo (image|audio|video|file), conteudo_base64, nome_arquivo, legenda
POST ?acao=enviar_enquetePOST /v1/messages/polldevice_id, telefone, pergunta, opcoes[], max_respostas
POST ?acao=reagirPOST /v1/messages/reactdevice_id, telefone, message_id, emoji
POST ?acao=editar_mensagemPOST /v1/messages/editdevice_id, telefone, message_id, mensagem
POST ?acao=apagar_mensagemPOST /v1/messages/deletedevice_id, telefone, message_id
POST ?acao=encaminharPOST /v1/messages/forwarddevice_id, telefone (destino), message_id

Ejemplo cURL (Enviar texto)

curl -X POST "https://api.nubetech.online/api.php?acao=enviar_mensagem" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "TU_TOKEN",
    "device_id": "t1_a1b2c3d4e5",
    "telefone": "5491122334455",
    "mensagem": "Hola! Te recordamos tu turno veterinario mañana a las 10:00 hs."
  }'

Grupos y Verificación de Números

Acción LegacyREST v1Campos
GET ?acao=listar_gruposGET /v1/groupsdevice_id
POST ?acao=enviar_msg_grupoPOST /v1/groups/senddevice_id, grupo_id, mensagem
POST ?acao=criar_grupoPOST /v1/groupsdevice_id, nome, participantes[]
POST ?acao=verificar_numero_whatsappPOST /v1/contacts/checkdevice_id, telefone

Perfil de Empresa y Cuenta

Acción LegacyREST v1Campos
GET ?acao=perfil_empresaGET /v1/profile/businessdevice_id, telefone (opcional, por defecto la instancia)
GET ?acao=info_usuarioGET /v1/profile/infodevice_id, telefone (opcional)
GET ?acao=obter_avatarGET /v1/profile/avatardevice_id, telefone (opcional)
POST ?acao=atualizar_avatarPOST /v1/profile/avatardevice_id, conteudo_base64, nome_arquivo (opc)
POST ?acao=atualizar_nomePOST /v1/profile/namedevice_id, nome (pushname visible)

Cola Antibaneo, Spintax y Opt-Out

Todos los envíos (enviar_mensagem, enviar_midia, enviar_enquete, enviar_msg_grupo) entran automáticamente en la cola asíncrona antibaneo y devuelven al instante "queued": true y "queue_id".

Acción LegacyREST v1Campos
GET ?acao=status_mensagemGET /v1/queue/{id}queue_id
GET ?acao=listar_filaGET /v1/queuedevice_id (opc), status (opc)
POST ?acao=cancelar_mensagemDELETE /v1/queue/{id}queue_id
GET ?acao=stats_antibaneoGET /v1/instances/{id}/antiban-statsdevice_id
POST ?acao=bloquear_contatoPOST /v1/optoutstelefone, motivo (opc)
POST ?acao=desbloquear_contatoDELETE /v1/optoutstelefone
GET ?acao=listar_bloqueadosGET /v1/optoutstoken

Webhooks Entrantes y Cron Periódico

Cada vez que llega un mensaje o cambia el estado de conexión de una instancia, el Gateway reenvía un POST JSON a la webhook_url configurada en esa instancia. Tu receptor debe responder HTTP 200 rápidamente.

Si la instancia tiene configurado un cron_url, el runner (scripts/run_crons.php) lo invoca periódicamente por POST JSON con evento: "cron", device_id, status y telefone para clientes activos y vigentes.

Cabeceras enviadas por el Gateway: X-ApiVip-Event, X-ApiVip-DeviceId y opcionalmente X-ApiVip-Signature (HMAC-SHA256).

Códigos de Estado HTTP

Admin API (para automatizar desde tu sistema de facturación)

Endpoint: https://api.nubetech.online/admin/api.php?acao=... con encabezado X-Admin-Key: TU_ADMIN_MASTER_KEY.