Documentación API

Bienvenido a la documentación de la API de Neveloopp MD.

Información Importante

La API requiere autenticación mediante API Key.

Autenticación

Todas las solicitudes a la API deben incluir tu API Key:

GET /api/endpoint
Headers:
  x-api-key: tu_api_key_aqui
  Content-Type: application/json

Número de Teléfono

El parámetro phone debe:

  • Sin + y sin espacios
  • Ejemplo: 1234567890
  • Debe estar conectado a tu cuenta

Ejecutar Método en Bot

POST /api/bot/execute

Ejecuta un método en un bot de WhatsApp.

Parámetros del Body

Parámetro Tipo Requerido Descripción
phone string Sí Número del bot sin formato
method string Sí Método a ejecutar
args array No Argumentos del método

Ejemplos de Uso

Node.js con Axios

const axios = require('axios');

// Configuración de la API
const API_BASE = 'https://tu-dominio.com';
const API_KEY = 'tu_api_key_aqui';

// Enviar mensaje de texto
async function sendMessage() {
  try {
    const response = await axios.post(`${API_BASE}/api/bot/execute`, {
      phone: '1234567890',
      method: 'sendMessage',
      args: [
        '1234567890@s.whatsapp.net',
        {
          text: '¡Hola desde la API!'
        }
      ]
    }, {
      headers: {
        'x-api-key': API_KEY,
        'Content-Type': 'application/json'
      }
    });

    console.log('Mensaje enviado:', response.data);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
}

sendMessage();

PHP con cURL

// Configuración
$api_base = 'https://tu-dominio.com';
$api_url = $api_base . '/api/bot/execute';
$api_key = 'tu_api_key_aqui';

// Datos para enviar mensaje
$data = [
    'phone' => '1234567890',
    'method' => 'sendMessage',
    'args' => [
        '1234567890@s.whatsapp.net',
        [
            'text' => '¡Hola desde PHP!'
        ]
    ]
];

// Configurar cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: ' . $api_key,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Ejecutar la solicitud
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code === 200) {
    echo "Mensaje enviado\n";
} else {
    echo "Error: " . $response . "\n";
}

Python con requests

import requests
import json

# Configuración
API_BASE = "https://tu-dominio.com"
API_URL = f"{API_BASE}/api/bot/execute"
API_KEY = "tu_api_key_aqui"

# Headers de la solicitud
headers = {
    "x-api-key": API_KEY,
    "Content-Type": "application/json"
}

# Datos para enviar mensaje
data = {
    "phone": "1234567890",
    "method": "sendMessage",
    "args": [
        "1234567890@s.whatsapp.net",
        {
            "text": "¡Hola desde Python!"
        }
    ]
}

try:
    # Realizar la solicitud POST
    response = requests.post(API_URL, json=data, headers=headers)
    
    if response.status_code == 200:
        result = response.json()
        print("Mensaje enviado:", result)
    else:
        print("Error:", response.json())
        
except Exception as e:
    print("Error de conexión:", e)

cURL desde terminal

# Enviar mensaje de texto usando cURL
curl -X POST "https://tu-dominio.com/api/bot/execute" \
  -H "x-api-key: tu_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "1234567890",
    "method": "sendMessage",
    "args": [
      "1234567890@s.whatsapp.net",
      {
        "text": "¡Hola desde cURL!"
      }
    ]
  }'

Métodos Disponibles

sendMessage

Envía un mensaje de texto.

{
  "phone": "1234567890",
  "method": "sendMessage",
  "args": [
    "1234567890@s.whatsapp.net",
    {
      "text": "Mensaje de ejemplo"
    }
  ]
}

sendImage

Envía una imagen.

{
  "phone": "1234567890",
  "method": "sendMessage",
  "args": [
    "1234567890@s.whatsapp.net",
    {
      "image": {
        "url": "https://ejemplo.com/imagen.jpg"
      },
      "caption": "Descripción"
    }
  ]
}

sendButtons

Envía botones interactivos.

{
  "phone": "1234567890",
  "method": "sendMessage",
  "args": [
    "1234567890@s.whatsapp.net",
    {
      "text": "Selecciona:",
      "buttons": [
        {
          "buttonId": "id1",
          "buttonText": {
            "displayText": "Opción 1"
          },
          "type": 1
        }
      ]
    }
  ]
}