Recaudo Docs
Crear cuenta

Conversaciones

Plantillas de WhatsApp

Consulta las plantillas aprobadas que puedes enviar

Listar plantillas

GET /v1/whatsapp-templates

Regresa todas las plantillas de WhatsApp de tu cuenta, con su estado de aprobación de Meta.

Ejemplo de petición 
curl https://recaudo.app/api/v1/whatsapp-templates \
  -H "Authorization: Bearer sk_live_tu_secret_key" \
  -H "Content-Type: application/json"
Respuesta 
{
  "object": "list",
  "data": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "name": "recordatorio_pago",
      "description": "Recordatorio de pago pendiente",
      "content_type": "text",
      "variables": ["nombre", "monto", "fecha_limite"],
      "meta_template_status": "APPROVED"
    },
    {
      "id": "98765432-10fe-dcba-9876-543210fedcba",
      "name": "confirmacion_pedido",
      "description": "Confirmación de pedido realizado",
      "content_type": "text",
      "variables": ["nombre", "numero_pedido"],
      "meta_template_status": "APPROVED"
    }
  ]
}

Las plantillas deben estar aprobadas por Meta (meta_template_status: "APPROVED") para poder ser enviados.

Enviar plantilla a un teléfono

POST /v1/conversations/send-template-to-phone

Envía una plantilla aprobada por Meta a cualquier número de WhatsApp, haya o no conversación previa. Úsalo para avisos iniciados por tu empresa: ligas de pago, firma de contrato, recordatorios.

curl -X POST https://recaudo.app/api/v1/conversations/send-template-to-phone \
  -H "Authorization: Bearer sk_live_tu_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+5215511112222",
    "template_name": "payment_link_message2",
    "variables": ["Ana López", "https://recaudo.app/pay/abc123", "Plan Previsión", "$1,983.45"],
    "phone_number_id": "opcional: UUID o meta_phone_number_id de la línea"
  }'
{
  "object": "conversation_message",
  "data": { "id": "9b1f…", "status": "sent", "external_id": "wamid.HBgN…" },
  "conversation_id": "01a1…",
  "from": { "phone_number_id": "fa8a…", "phone_number": "+5212202110494" }
}
  • variables: posicionales, como lista ["Ana", "..."] o como objeto {"1": "Ana"}. La plantilla se puede indicar con template_id o template_name.
  • phone_number_id (opcional): línea emisora. Si no lo mandas, sale por la línea de la cuenta de WhatsApp de la plantilla.
  • Estatus: suscribe tu webhook a conversation.message.status_updated (entregado, leído, fallido) y conversation.message.received (respuestas y botones).
  • Errores 422 con error.code: template_not_found, invalid_phone_number, template_line_mismatch, no_sending_line, send_failed.
¿Te sirvió esta página? Gracias por avisarnos.
Esc