WhatsApp Business

Obtener plantillas aprobadas de WhatsApp Business

get

Retorna todas las plantillas (templates) que están aprobadas en la cuenta de WhatsApp Business vinculada.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Plantillas obtenidas exitosamente

application/json

400

Conexión de WhatsApp Business no encontrada

application/json

401

No autorizado (API Key ausente o inválida)

application/json

500

Error al obtener plantillas

application/json

get

/whatsapp-business/templates

HTTPcURLJavaScriptPython

GET /public/v1/whatsapp-business/templates HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "templates": [
    {
      "id": "text",
      "name": "hello_world",
      "language": "es",
      "status": "APPROVED",
      "category": "MARKETING",
      "components": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    }
  ]
}

Enviar mensaje de texto por WhatsApp Business

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

phone_numberstringRequiredExample: 5491122334455

messagestringRequiredExample: Hola! Esto es un mensaje de prueba.

Responses

200

Enviado

application/json

400

Error de validación, ventana 24h, o conexión WABA ausente

application/json

401

No autorizado (API Key ausente o inválida)

application/json

500

Error interno al enviar el mensaje

application/json

post

/whatsapp-business/message/text

HTTPcURLJavaScriptPython

POST /public/v1/whatsapp-business/message/text HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "phone_number": "5491122334455",
  "message": "Hola! Esto es un mensaje de prueba."
}

{
  "success": true,
  "message": "Text message sent successfully",
  "data": {
    "whatsapp_business_response": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "phone_number": "text",
    "sent_at": "2026-02-03T21:17:24.870Z"
  }
}

Enviar imagen por WhatsApp Business

post

Campo del archivo: "image". Tamaño máximo 5MB. Solo imágenes (image/*).

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

phone_numberstringRequired

Número de teléfono en formato internacional

Example: 5491122334455

captionstring · nullableOptional

Texto opcional del pie de foto

imagestring · binaryRequired

Archivo de imagen (máx 5MB)

Responses

200

Enviado

application/json

400

Error de validación, tipo de archivo no permitido o límites de Multer

application/json

401

No autorizado (API Key ausente o inválida)

application/json

500

Error interno al enviar la imagen

application/json

post

/whatsapp-business/message/image

HTTPcURLJavaScriptPython

POST /public/v1/whatsapp-business/message/image HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 66

{
  "phone_number": "5491122334455",
  "caption": "text",
  "image": "binary"
}

{
  "success": true,
  "message": "Image sent successfully",
  "data": {
    "whatsapp_business_response": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "phone_number": "text",
    "file_name": "text",
    "file_size": 1,
    "caption": "text",
    "sent_at": "2026-02-03T21:17:24.870Z"
  }
}

Enviar mensaje usando una plantilla de WhatsApp Business

post

Envía un mensaje usando una plantilla (template) aprobada a un número específico. Las plantillas pueden incluir parámetros dinámicos. Este endpoint NO requiere que el contacto haya enviado un mensaje en las últimas 24 horas.

Soporte de Media: Si la plantilla tiene un header con media (IMAGE, VIDEO, DOCUMENT), el sistema buscará automáticamente el archivo asociado en la configuración de Template Media de tu organización. No es necesario enviar la URL del media en cada request.

Soporte de Buttons Dinámicos: Si la plantilla tiene botones URL con variables (ej: https://example.com/{{order_id}}), puedes enviar los valores en el campo parameters usando el nombre de la variable como key.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

phone_numberstringRequired

Número de teléfono en formato internacional

Example: 5491122334455

template_namestringRequired

Nombre de la plantilla a enviar

Example: hello_world

template_languagestringRequired

Código de idioma de la plantilla

Example: es

media_urlstring · nullableOptional

URL pública del archivo media para el header (opcional). Si la plantilla tiene un header con media (IMAGE, VIDEO, DOCUMENT) y este campo está presente, se usará esta URL en lugar del media configurado en Template Media. Si no se proporciona, el sistema buscará automáticamente el media asociado.

Example: https://example.com/image.jpg

media_filenamestring · nullableOptional

Nombre del archivo (opcional, recomendado para documentos). Solo aplica cuando media_url está presente y el header es de tipo DOCUMENT. Si no se proporciona, el documento puede mostrarse como "Untitled" en WhatsApp.

Example: factura-2024.pdf

Responses

200

Mensaje con plantilla enviado exitosamente

application/json

400

Error de validación o plantilla no encontrada/no aprobada

application/json

401

No autorizado (API Key ausente o inválida)

application/json

500

Error interno al enviar el mensaje con plantilla

application/json

post

/whatsapp-business/message/template

HTTPcURLJavaScriptPython

POST /public/v1/whatsapp-business/message/template HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 237

{
  "phone_number": "5491122334455",
  "template_name": "hello_world",
  "template_language": "es",
  "parameters": {
    "name": "Juan",
    "code": "1234",
    "meeting_id": "abc-xyz-123"
  },
  "media_url": "https://example.com/image.jpg",
  "media_filename": "factura-2024.pdf"
}

{
  "success": true,
  "message": "Template message sent successfully",
  "data": {
    "whatsapp_business_response": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "phone_number": "5491122334455",
    "template_name": "hello_world",
    "template_language": "es",
    "has_media": true,
    "media_url": "https://storage.googleapis.com/...",
    "sent_at": "2026-02-03T21:17:24.870Z"
  }
}