{"openapi":"3.1.0","info":{"title":"WapiFlex Template Messaging API","version":"1.0.0","description":"API para consultar plantillas Meta WhatsApp Cloud, estimar costos y crear envíos individuales o masivos."},"servers":[{"url":"https://wapiflex.link"}],"security":[{"WapiFlexPublicKey":[],"WapiFlexSecretKey":[]}],"paths":{"/api/v1/connection":{"get":{"summary":"Validar credenciales y sesión","responses":{"200":{"description":"Conexión disponible"}}}},"/api/v1/templates":{"get":{"summary":"Listar plantillas aprobadas","responses":{"200":{"description":"Plantillas disponibles"}}}},"/api/v1/templates/{templateId}":{"get":{"summary":"Consultar plantilla y variables","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Detalle de plantilla"}}}},"/api/v1/template-messages/estimate":{"post":{"summary":"Estimar costo de un envío","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateMessageRequest"}}}},"responses":{"200":{"description":"Estimación referencial"}}}},"/api/v1/template-messages/send":{"post":{"summary":"Crear un job de envío","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateMessageRequest"}}}},"responses":{"202":{"description":"Job en cola"},"409":{"description":"Conflicto de idempotencia"}}}},"/api/v1/template-messages":{"get":{"summary":"Listar jobs creados por la API Key","responses":{"200":{"description":"Historial de jobs"}}}},"/api/v1/template-messages/{jobId}":{"get":{"summary":"Consultar estado y resultado por destinatario","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Detalle del job"}}}}},"components":{"securitySchemes":{"WapiFlexPublicKey":{"type":"apiKey","in":"header","name":"x-public-key"},"WapiFlexSecretKey":{"type":"apiKey","in":"header","name":"x-secret-key"}},"schemas":{"TemplateMessageRequest":{"type":"object","required":["template_id","recipients"],"properties":{"template_id":{"type":"integer","example":123},"currency":{"type":"string","example":"PEN"},"variables":{"type":"object","additionalProperties":{"type":"string"},"description":"Valores comunes para todos los destinatarios."},"recipients":{"type":"array","minItems":1,"maxItems":250,"items":{"type":"object","required":["phone"],"properties":{"phone":{"type":"string","example":"51999999999"},"external_id":{"type":"string"},"variables":{"type":"object","additionalProperties":{"type":"string"},"example":{"body.1":"Carlos","body.2":"S/ 100.00"}}}}}}}}}}