Channels

Enviar una plantilla HSM aprobada por WhatsApp. Con ?dry_run=true valida la plantilla y devuelve el mensaje resuelto sin enviarlo.

La única forma de escribirle primero a alguien o de retomar una conversación pasadas 24 horas del último mensaje del contacto: fuera de esa ventana WhatsApp solo entrega plantillas aprobadas. El name, el language y los components que pide salen de GET /channels/{channelId}/templates.

post/channels/{channelId}/whatsapp/send-template

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/channels/{channelId}/whatsapp/send-template
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Path parameters

channelIdstring required

ID del canal conectado.

Query parameters

dry_runstring required

En true valida y devuelve el resultado sin escribir nada.

Request body

componentsobject[]

Components de la plantilla (header/body/buttons con sus parameters), tal como los define Meta.

contact_idnumber required

ID del contacto destinatario.

languagestring required

Código de idioma de la plantilla (ISO + variante). Meta es estricto: 'es', 'es_CO', 'en_US'.

purpose'authentication'

Excepción OTP habilitada únicamente para AveOnline (workspace 60). Exige una plantilla APPROVED/AUTHENTICATION en la cuenta emisora. No reactiva el piloto ni modifica la atención humana; mantiene bloqueos y permisos. Omitido conserva el comportamiento normal.

sender_line_idstring

Línea desde la que se envía: su phone_number_id de Meta, tal como lo devuelve GET /channels/{channelId}/whatsapp/lines. Omitido = la línea por la que el contacto escribió por última vez o, si nunca escribió, la del canal. Tiene que ser una línea activa del workspace: si no lo es, el envío falla en vez de salir por otro número. La plantilla tiene que existir en la cuenta (WABA) de esa línea.

template_namestring required

Nombre exacto de la plantilla HSM aprobada en Meta.

Example request

{
  "components": [
    {
      "parameters": [
        {
          "text": "Cristhian",
          "type": "text"
        },
        {
          "text": "$1.500.000",
          "type": "text"
        }
      ],
      "type": "body"
    }
  ],
  "contact_id": 12345,
  "language": "es_CO",
  "sender_line_id": "1210946622112871",
  "template_name": "recordatorio_pago"
}

Response

Envío real: {success, wa_message_id}. Con ?dry_run=true: {dry_run, would_send} con la plantilla resuelta y sin enviar nada.

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "wa_message_id": "wamid.HBgMNTczMDAxMTEyMjMzFQIAERgSN0EyM…"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.