Send WhatsApp Business API

TYPE_MESSAGE = [“text”, “image”, “video”, “document”, “audio”, “template”] Important:

Al enviar mensajes multimedia (image, video, audio, document), el parámetro body debe contener la URL pública del archivo.
Al enviar plantillas preaprobadas (template), debes especificar el objeto template con su nombre, idioma y los componentes de variables o botones (especialmente para plantillas de Authentication / OTP).

Optional parameters

caption string = Texto explicativo al enviar imágenes o videos.
template object = Configuración y parámetros de la plantilla (requerido cuando type = "template").

POST /v1/whatsapp-api

Body (Mensaje estándar)

{
  "token": "{{token}}",
  "type": "text",
  "body": "Hi 👋!!",
  "to": "NUMBER_WHATSAPP",
  "instance": "{{instance}}"
}

Body (Envío de plantilla de Autenticación / OTP)

Para despachar una plantilla de la categoría Authentication con botones de copiar código (copy_code) o autocompletar (one_tap / zero_tap), se envía el código OTP en los parámetros del cuerpo y del botón.

{
  "token": "{{token}}",
  "type": "template",
  "to": "50499999999",
  "instance": "{{instance}}",
  "template": {
    "name": "verificacion_portal_v2",
    "language": {
      "code": "es_MX"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "849201"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": 0,
        "parameters": [
          {
            "type": "text",
            "text": "849201"
          }
        ]
      }
    ]
  }
}

Inyección automática de variable OTP: En plantillas de autenticación, la variable {{1}} inyecta el código de verificación de 4 a 8 dígitos tanto en el texto predeterminado del cuerpo como en el botón OTP dinámico (sub_type: "url", index: 0).

Métodos de entrega admitidos en plantillas OTP

El comportamiento del botón en el dispositivo del destinatario depende de cómo se haya registrado la plantilla en Meta:

Método	Configuración de plantilla	Comportamiento en WhatsApp
`copy_code`	Sin requisitos adicionales de app	Botón interactivo para copiar el código al portapapeles.
`one_tap`	Requiere `package_name` y `app_signature_hash` (11 caracteres)	Al pulsar el botón, WhatsApp envía el código a tu app Android. Se degrada a `copy_code` si el dispositivo no es compatible.
`zero_tap`	Requiere `package_name`, `app_signature_hash` y aceptación de términos	WhatsApp entrega el código a tu app en segundo plano sin pulsar botones. Se degrada a `one_tap` o `copy_code` en caso de incompatibilidad.

Autenticacion

Este endpoint requiere tu token de API. Incluyelo en el body como token o como query param token/api-token. Ve Autenticacion para mas detalles.

Ejemplo de request

curl -X POST https://api.shimli.app/v1/whatsapp-api \
  -H "Content-Type: application/json" \
  -d '{
    "token": "{{token}}",
    "type": "template",
    "to": "50499999999",
    "instance": "{{instance}}",
    "template": {
      "name": "verificacion_portal_v2",
      "language": {
        "code": "es_MX"
      },
      "components": [
        {
          "type": "body",
          "parameters": [{ "type": "text", "text": "849201" }]
        },
        {
          "type": "button",
          "sub_type": "url",
          "index": 0,
          "parameters": [{ "type": "text", "text": "849201" }]
        }
      ]
    }
  }'

Respuesta

{
  "success": true,
  "messageId": "wamid.HBgLM...",
  "status": "sent"
}

Autenticación

Mensajería

CRM

Agentes

Contactos

Live Chat

Campañas

Shop

Short Links

Send WhatsApp Business API

Body (Mensaje estándar)

Body (Envío de plantilla de Autenticación / OTP)

Métodos de entrega admitidos en plantillas OTP

Autenticacion

Ejemplo de request

Respuesta

​Body (Mensaje estándar)

​Body (Envío de plantilla de Autenticación / OTP)

​Métodos de entrega admitidos en plantillas OTP

​Autenticacion

​Ejemplo de request

​Respuesta

Body (Mensaje estándar)

Body (Envío de plantilla de Autenticación / OTP)

Métodos de entrega admitidos en plantillas OTP

Autenticacion

Ejemplo de request

Respuesta