API de WhatsApp y CRM para negocios

Para que sirve

Automatiza lo que pasa fuera de Vuntrix

La API esta pensada para negocios que ya tienen otro sistema y quieren que WhatsApp y el CRM se actualicen solos: talleres de costura, tiendas online, reservas, pedidos, soporte, clinicas o servicios profesionales.

Costura y talleresActualiza estados como medidas recibidas, corte iniciado, en confeccion o listo para recoger.

Ecommerce y pedidosCrea pedidos, guarda telefono real, cambia estado y avisa por WhatsApp o email.

Marketing responsableVerifica numeros antes de contactar y respeta tus limites de cuenta.

Autenticacion

Usa `X-API-Key`

Genera una clave desde el dashboard. En cada peticion envia la cabecera X-API-Key. La clave queda asociada a tu cuenta, tus limites y tus sesiones conectadas.

No compartas la clave en frontend publico.
Usala desde tu servidor, backend, ERP o automatizacion privada.
Para enviar WhatsApp necesitas una sesion conectada en tu cuenta.

curl https://vuntrix.com/api/v1/orders \
  -H "X-API-Key: vtx_TU_API_KEY" \
  -H "Content-Type: application/json"

La API de Vuntrix no es la API oficial de Meta. Opera sobre las sesiones WhatsApp que conectas en Vuntrix.

CRM / pedidos

Crear o actualizar un pedido sin avisar al cliente

Usa externalId para que tu sistema pueda actualizar siempre el mismo pedido. Con enviarCliente: "no" solo se guarda en CRM.

curl -X POST https://vuntrix.com/api/v1/orders \
  -H "X-API-Key: vtx_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "costura-1001",
    "nombre": "Maria Gomez",
    "telefono": "34600111222",
    "prenda": "Vestido a medida",
    "estado": "corte_iniciado",
    "estadoLabel": "Corte iniciado",
    "notas": "Medidas tomadas y tela confirmada",
    "enviarCliente": "no"
  }'

Avisar solo cuando decidas

Cuando tu equipo quiera enviar un informe, cambia enviarCliente a si y agrega mensajeCliente.

curl -X PATCH https://vuntrix.com/api/v1/orders/costura-1001/status \
  -H "X-API-Key: vtx_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "estado": "listo_para_recoger",
    "estadoLabel": "Listo para recoger",
    "enviarCliente": "si",
    "canal": ["whatsapp", "email"],
    "mensajeCliente": "Hola Maria, tu vestido ya esta listo para recoger."
  }'

Mensajes y verificacion

Enviar WhatsApp o verificar numeros

Para mensajes directos usa /api/send-messages. Para limpiar listas o validar telefonos usa /api/check-numbers. Puedes indicar sessionId, prefix y delayMs.

curl -X POST https://vuntrix.com/api/send-messages \
  -H "X-API-Key: vtx_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "ses_xxx",
    "prefix": "34",
    "delayMs": 3000,
    "numbers": ["600111222"],
    "text": "Hola, tu pedido ya esta en preparacion."
  }'

Columnas personalizadas

Crea tu propio flujo CRM

Puedes crear columnas desde el dashboard en CRM / Leads -> Flujo / columnas, o guardarlas por API para negocios con estados propios.

curl -X PUT https://vuntrix.com/api/v1/crm/flow \
  -H "X-API-Key: vtx_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "columns": [
      { "id": "nuevo", "label": "Nuevo pedido" },
      { "id": "medidas_recibidas", "label": "Medidas recibidas" },
      { "id": "corte_iniciado", "label": "Corte iniciado" },
      { "id": "en_confeccion", "label": "En confeccion" },
      { "id": "listo_para_recoger", "label": "Listo para recoger" },
      { "id": "entregado", "label": "Entregado", "terminal": true }
    ]
  }'

Referencia rapida

Endpoints principales

Metodo	Ruta	Uso
GET	`/api/sessions`	Listar sesiones WhatsApp de la cuenta.
POST	`/api/check-numbers`	Verificar numeros de WhatsApp en lote.
POST	`/api/send-messages`	Enviar mensajes por WhatsApp desde una sesion conectada.
GET	`/api/v1/orders`	Listar pedidos/leads del CRM.
POST	`/api/v1/orders`	Crear o actualizar un pedido/lead.
PATCH	`/api/v1/orders/:id`	Actualizar datos del pedido/lead.
PATCH	`/api/v1/orders/:id/status`	Cambiar estado y opcionalmente avisar al cliente.
POST	`/api/v1/orders/:id/messages`	Enviar un mensaje puntual al cliente del pedido.
GET	`/api/v1/crm/flow`	Consultar columnas del CRM.
PUT	`/api/v1/crm/flow`	Guardar columnas personalizadas del CRM.

Los endpoints respetan permisos, limites y estado de servicio de la cuenta. Si la cuenta no tiene API externa activa, Vuntrix devuelve error de permisos.

Buenas practicas

Usala con control

Guarda un externalId estable por pedido para evitar duplicados.
No actives enviarCliente hasta que el mensaje este revisado por tu sistema o tu equipo.
Usa delayMs en lotes para evitar envios agresivos.
Manten consentimiento y buenas practicas anti-spam para marketing.

Quieres probarlo?

Entra al panel, crea una API key y copia los ejemplos de esta pagina. Si necesitas ayuda, abre soporte desde la web.

Entrar al panel Leer manual