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",
    "codigo": "VTX-COS1001",
    "nombre": "Maria Gomez",
    "telefonoReal": "34600111222",
    "email": "maria@example.com",
    "situacion": "interesado",
    "prenda": "Vestido a medida",
    "variante": "Azul / talla M",
    "cantidad": "1",
    "total": "120 EUR",
    "presupuesto": "100-130 EUR",
    "metodoPago": "Efectivo",
    "entrega": "recogida",
    "ciudad": "Murcia",
    "cp": "30001",
    "direccion": "Calle Mayor 12",
    "referencia": "Local junto a la farmacia",
    "trackingUrl": "https://tuweb.com/seguimiento?code=VTX-COS1001",
    "estado": "corte_iniciado",
    "estadoLabel": "Corte iniciado",
    "prioridad": "alta",
    "etiquetas": ["vip", "urgente", "repetir compra"],
    "resumen": "Cliente quiere un vestido a medida con recogida en tienda.",
    "siguientePaso": "Confirmar prueba final y hora de recogida.",
    "seguimiento": "2026-07-20T10:00:00+02:00",
    "cierreEstimado": "2026-07-23T18:00:00+02:00",
    "notas": "Medidas tomadas y tela confirmada",
    "enviarCliente": "no"
  }'

Campos que puedes rellenar en la ficha del CRM

Estos campos son los mismos que se ven en la ficha del lead. Puedes mandar los nombres principales o sus aliases; Vuntrix los normaliza y guarda el lead en el flujo de esa cuenta.

Campo CRM	Variables aceptadas	Notas
Identificador externo	`externalId`, `pedidoId`, `orderId`, `code`	Clave estable de tu sistema. Sirve para actualizar el mismo lead sin duplicarlo.
Código del pedido	`codigo`, `orderCode`, `code`	Opcional. Si no lo envías, Vuntrix genera uno.
Contacto base	`contactId`, `telefono`, `phone`, `whatsapp`	Obligatorio para crear si no envías `telefonoReal`. Puede ser el número WhatsApp.
Teléfono real del cliente	`telefonoReal`, `customerPhone`, `phoneReal`, `realPhone`	Recomendado siempre. Obligatorio si luego asignas el lead a un comercial o quieres abrir WhatsApp del cliente desde el CRM.
Email	`email`, `correo`, `customerEmail`	Necesario si quieres avisos por correo.
Estado / columna	`estado`, `status`, `stage`, `column`	Si no existe en el flujo, Vuntrix crea la columna para esa cuenta. Usa `estadoLabel` para el nombre visible.
Prioridad	`prioridad`, `priority`	Acepta `baja`, `media`, `alta`, `urgente`.
Situación	`situacion`, `buyerStatus`	Ejemplos: `frio`, `interesado`, `urgente`.
Categoría / necesidad	`categoria`, `category`, `motivo`, `need`	Ejemplo: arreglo, reserva, pedido, soporte, compostura.
Producto / servicio	`producto`, `product`, `prenda`, `servicio`	Lo que pidió o está consultando el cliente.
Variante	`variante`, `variant`, `talla`, `size`	Talla, color, modelo o versión.
Cantidad	`cantidad`, `quantity`	Numero o texto libre.
Total esperado	`precio_total`, `precioTotal`, `total`, `expectedTotal`, `precio`	Importe estimado o total del pedido. Si mandas `precio` y `precio_total`, Vuntrix guarda el total y añade el precio base al resumen.
Presupuesto	`presupuesto`, `budget`, `precio_base`	Rango o límite que indicó el cliente.
Método de pago	`metodoPago`, `metodo_pago`, `paymentMethod`, `payment`	Bizum, efectivo, tarjeta, transferencia, texto libre, etc.
Entrega	`entrega`, `entrega_tipo`, `deliveryType`	Ejemplos: `domicilio`, `recogida`, `envio`, `tienda`.
Origen	`origen`, `source`	Ejemplo: `web`, `api`, `ia`, `costura-app`.
Ciudad	`ciudad`, `city`	Ciudad del cliente.
Código postal	`codigo_postal`, `codigoPostal`, `cp`, `postalCode`, `zip`	Se guarda como texto.
Dirección	`direccion_envio`, `direccionEnvio`, `direccion`, `address`	Dirección de entrega o recogida.
Referencia de entrega	`referenciaEntrega`, `deliveryReference`	Piso, puerta, indicaciones o referencia.
Tracking	`trackingUrl`, `tracking_url`, `trackingLink`, `trackingCode`	Enlace o codigo de seguimiento para mensajes personalizados.
Seguimiento	`seguimiento`, `nextFollowUpAt`, `followUpAt`	Fecha ISO para próximo seguimiento.
Cierre estimado	`estimado_at`, `estimatedCloseAt`, `dueAt`	Fecha ISO esperada de cierre, entrega o cita.
Etiquetas	`etiquetas`, `tags`	Array o texto separado por comas. Máximo 8 etiquetas.
Resumen	`descripcion`, `description`, `resumen`, `summary`	Resumen visible del lead.
Logística extra	`distancia_km`, `distanciaKm`, `envio_precio`, `envioPrecio`	No tienen campo propio todavía; se añaden al resumen para no perder el dato.
Siguiente paso	`siguientePaso`, `nextAction`	Qué debe hacer el equipo para cerrar o avanzar.
Notas internas	`notas`, `notes`	Información privada del equipo.
Motivo de cancelación	`motivoCancelacion`, `cancelReason`	Solo si aplica.
Avisar al cliente	`enviarCliente`, `notifyCustomer`, `sendCustomer`	`true`, `si` o `1` envia WhatsApp/email segun datos y sesion activa. `false`, `no` o `0` solo actualiza el CRM.

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",
    "trackingUrl": "https://tuweb.com/seguimiento?code=VTX-COS1001",
    "enviarCliente": "si",
    "canal": ["whatsapp", "email"],
    "mensajeCliente": "Hola Maria, tu vestido ya esta listo para recoger."
  }'

Seguimiento comercial

Detecta clientes que dejaron de responder

Activa la funcion por sesion desde Dashboard -> Sesiones -> Clientes sin respuesta. Vuntrix registra el primer mensaje del cliente, espera una respuesta escrita manualmente por el comercial y cambia el estado cuando vence el plazo.

waiting_commercial: el cliente escribio y falta respuesta humana.
waiting_customer: el comercial respondio y se espera al cliente.
no_response: vencio el plazo sin respuesta.
replied o replied_late: el cliente volvio a escribir.

Los mensajes de IA, campanas y respuestas automaticas no inician este seguimiento. El identificador de WhatsApp se conserva por sesion y nunca se publica como telefono hasta resolverlo o vincularlo desde tu CRM.

curl https://vuntrix.com/api/v1/follow-ups \
  -H "X-API-Key: vtx_TU_API_KEY"

Para enlazar una conversacion con el telefono real, envia su conversationId al crear el lead:

curl -X POST https://vuntrix.com/api/v1/orders \
  -H "X-API-Key: vtx_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceConversationId": "conv_xxx",
    "sessionId": "ses_xxx",
    "externalId": "crm-1001",
    "telefonoReal": "34600111222",
    "nombre": "Maria Gomez"
  }'

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/follow-ups`	Listar conversaciones humanas y su estado de respuesta en todas las sesiones activadas.
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