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": "2025-12-08T10:24:53.994Z"
  }
}

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": "2025-12-08T10:24:53.994Z"
  }
}

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.

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

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: 130

{
  "phone_number": "5491122334455",
  "template_name": "hello_world",
  "template_language": "es",
  "parameters": {
    "name": "Juan",
    "code": "1234"
  }
}

{
  "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",
    "sent_at": "2025-12-08T10:24:53.994Z"
  }
}