Contactos y Grupos

Verificar Número (Checker)

Verifica instantáneamente si un número tiene una cuenta de WhatsApp activa antes de intentar enviar un mensaje.

json
GET /contact/check/{instanceName}/{number}

// Respuesta 200
{
  "exists": true,
  "jid": "5491112345678@s.whatsapp.net"
}

Crear Grupo

Crea un grupo de WhatsApp y agrega participantes automáticamente. Nota: Algunos participantes pueden tener configuraciones de privacidad que eviten que sean agregados directamente a grupos.

json
POST /group/create

{
  "instanceName": "acme__soporte__main",
  "subject": "Soporte Técnico VIP",
  "participants": ["5491112345678", "5491187654321"],
  "description": "Grupo de asistencia técnica rápida 24/7"
}

// Respuesta 200

Gestionar Participantes de Grupo

Agrega, elimina o cambia los permisos de los administradores del grupo.

  • add: Añadir participantes
  • remove: Eliminar participantes
  • promote: Hacer administrador a un participante
  • demote: Quitar rol de administrador
json
POST /group/participants

{
  "instanceName": "acme__soporte__main",
  "groupJid": "1234567890-123456@g.us",
  "action": "add", // Opciones: "add", "remove", "promote", "demote"
  "participants": ["5491112345678"]
}

// Respuesta 200

Obtener Información del Grupo

Recupera la metadata completa del grupo y la lista actual de participantes.

json
GET /group/fetch/{instanceName}/{groupJid}

// Respuesta 200
{
  "id": "1234567890-123456@g.us",
  "subject": "Soporte Técnico VIP",
  "participants": [
    { "id": "5491112345678@s.whatsapp.net", "admin": "admin" },
    ...
  ]
}