API REST · Webhooks

Automatiza WhatsApp desde tus sistemas

Envía mensajes, plantillas y notificaciones desde tu ERP, CRM, e‑commerce, POS o herramientas no‑code (Zapier, Make, n8n). Una sola API, compatible con el formato de Meta.

Inicio rápido

Genera un token por línea en el panel: API → Generar token. Luego llama al endpoint.

Autenticación

Cabecera Authorization: Bearer <tu_token>. Cada línea (número) tiene su token.

Endpoint de envío

POST http://v2.wis.chat/api/v22.0/{TID}/messages
Authorization: Bearer TU_TOKEN
Content-Type: application/json

{TID} = el Phone Number ID de la línea (o su id interno), visible en API del panel.

Enviar un texto

curl -X POST "http://v2.wis.chat/api/v22.0/<TID>/messages" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"593999999999","type":"text","text":{"body":"Tu pedido #1234 fue facturado ✅"}}'

Enviar una plantilla (con variables)

{"to":"593999999999","type":"template",
 "template":{"name":"factura_lista","language":{"code":"es"},
   "components":[{"type":"body","parameters":[{"type":"text","text":"Juan"},{"type":"text","text":"#1234"}]}]}}

Enviar imagen / documento

{"to":"593999999999","type":"document",
 "document":{"link":"https://tu-dominio.com/factura-1234.pdf","filename":"factura-1234.pdf","caption":"Tu factura"}}

Respuesta

{"success":true,"wa_message_id":"wamid...","gateway":{"line":1,"quality":"GREEN"}}

Consultar las plantillas de la línea

Devuelve las plantillas que WisChat tiene registradas, para sincronizarlas en tu sistema sin manejar credenciales de Meta. Con ?refresh=1 se resincroniza antes con Meta (solo líneas Cloud API; hay un enfriamiento de 60 s entre refrescos).

curl "http://v2.wis.chat/api/v22.0/<TID>/templates?status=approved" \
  -H "Authorization: Bearer TU_TOKEN"
{"success":true,
 "line":{"id":1,"phone_number":"593...","channel":"cloud_api","requires_meta_approval":true},
 "synced_at":"2026-08-25T10:00:00-05:00","count":2,
 "data":[{"name":"factura_lista","language":"es","category":"UTILITY",
          "status":"approved","meta_status":"APPROVED","quality_score":"GREEN",
          "header":{"type":"text","text":"Tu factura"},"body":"Hola {{1}}, tu factura {{2}} está lista.",
          "footer":null,"buttons":[],"variables":2,"is_starter":false}]}

Filtros: status=approved|pending|rejected|disabled · limit=1..500 (200 por defecto).

Estado de conexión de la línea

Solo lectura, sirve para monitorización: devuelve el estado que reporta Meta para la línea Cloud API.

curl "http://v2.wis.chat/api/v22.0/<TID>/status" \
  -H "Authorization: Bearer TU_TOKEN"
{"success":true,
 "line":{"id":1,"name":"Soporte","phone_number":"593...","channel":"cloud_api",
         "is_active":true,"api_enabled":true},
 "connected":true,"state":"connected","checked_at":"2026-08-25T10:24:00-05:00",
 "meta":{"meta_status":"CONNECTED","quality_rating":"GREEN","messaging_limit":"TIER_1K",
         "verified_name":"Mi Empresa","name_status":"APPROVED","has_credentials":true,
         "last_checked_at":"2026-08-25T10:00:00-05:00","refresh":{"requested":false}}}

state puede ser connected, disconnected o unknown (línea nunca consultada a Meta). Cuando es unknown, connected vale null en lugar de mentir. Con ?refresh=1 se consulta a Meta en el momento.

Migrar números entre cuentas (partners)

¿Pre-activas números a tu nombre y luego los traspasas a la WABA de tu cliente? Guía paso a paso (interfaz y API), qué se conserva, facturación y límites reales.

📄 Ver guía de migración de números →

Recibir mensajes (webhooks)

Para que tu CRM/ERP reciba los mensajes entrantes y estados de entrega, configura la URL de tu sistema en el panel: Líneas → Editar → Reenvío RAW a CRM. WisChat hará POST del evento (formato Meta) a esa URL en tiempo real.

Descargas y conectores

Empieza en minutos con una colección lista, o usa los conectores no‑code.

⬇ Postman ⬇ OpenAPI ⬇ Plugin WooCommerce (.zip) ⬇ Workflow n8n ⬇ SDK PHP ⬇ SDK Node

WooCommerce

Instala el .zip (Plugins → Subir) y en Ajustes → WisChat pon URL, Token y TID. Notifica al completar el pedido.

Zapier

Acción Webhooks by Zapier → POST. URL del endpoint, header Authorization: Bearer, tipo JSON y el cuerpo del mensaje.

Make (Integromat)

Módulo HTTP → Make a request: método POST, mismo header y JSON. Mapea el teléfono desde el paso anterior.

n8n

Importa el workflow, reemplaza TID y TOKEN en el nodo HTTP Request.

Shopify

Crea un Webhook (orders/paid) → apúntalo a un endpoint intermedio (o Make/Zapier) que llame a la API de WisChat.

PrestaShop / Magento

En el evento de pedido pagado, haz un POST con cURL/Guzzle al endpoint. Usa el SDK PHP.

HubSpot / Salesforce / Pipedrive

En un Workflow, acción "Webhook/HTTP" al cerrar el deal → POST al endpoint con el teléfono del contacto.

Odoo / SAP B1 / Dynamics / Sage / Contífico

Automatización/servidor que, al confirmar factura, llama al endpoint. Usa OpenAPI para generar el cliente o el SDK PHP.

Ejemplo WooCommerce (functions.php del tema o un plugin)

add_action('woocommerce_order_status_completed', function($order_id){
  $order = wc_get_order($order_id);
  $to = preg_replace('/\D+/', '', $order->get_billing_phone());
  wp_remote_post('http://v2.wis.chat/api/v22.0/<TID>/messages', [
    'headers' => ['Authorization'=>'Bearer TU_TOKEN','Content-Type'=>'application/json'],
    'body' => json_encode([
      'to' => $to, 'type' => 'text',
      'text' => ['body' => 'Tu pedido #'.$order_id.' fue confirmado ✅']
    ]),
  ]);
});

Integraciones listas

Conecta WisChat con tus plataformas. Cada una llama a la API al ocurrir un evento (venta, factura, deal, pedido…).

CategoríaPlataformasCómo integrar
ERPsOdoo, SAP Business One, Dynamics 365 BC, Sage, Zoho, ContíficoMódulo/addon que llama a la API al confirmar una venta/factura.
CRMsHubSpot, Salesforce, Zoho CRM, PipedriveWorkflow/webhook que dispara el envío al cerrar un deal.
E‑commerceWooCommerce, Shopify, PrestaShop, MagentoPlugin/webhook que notifica al completarse el pedido.
POS / RetailLoyverse, cajas localesAviso por API al cerrar la venta.
ContabilidadQuickBooks, ContíficoConector que sincroniza y notifica.
Middleware / no‑codeZapier, Make, n8nConector HTTP genérico (sin código).

¿Necesitas ayuda con una integración específica? Escríbenos: ventas@wis.chat · WhatsApp.