WA template

2026-10-02 21:59:13 +05:30 · 2026-10-02 21:59:13 +05:30 · d272ae0bd3
commit d272ae0bd3
parent 7a2e21ba61
12 changed files with 1359 additions and 5 deletions
--- a/backend/app/routes_agent_messages.py
+++ b/backend/app/routes_agent_messages.py
@ -0,0 +1,106 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy import select
+from sqlalchemy.orm import Session
+
+from .agent_message_service import SendAgentMessagePayload, get_template_by_slug, send_agent_template_message
+from .api_key_auth import current_api_user
+from .database import get_db
+from .models import AgentMessageTemplate, UserAccount
+
+router = APIRouter(prefix="/api/v1/agent", tags=["agent-messages"])
+
+
+def _explorer_doc_for_template(template: AgentMessageTemplate) -> dict:
+    return {
+        "id": "send-agent-message",
+        "method": "POST",
+        "path": "/api/v1/agent/messages/send",
+        "title": "Send agent WhatsApp message",
+        "summary": (
+            "Send an approved agent completion template through Urmi. Urmi authenticates your API key "
+            "and delivers the WhatsApp message from the Urmi AI business number on your behalf."
+        ),
+        "authentication": {
+            "type": "api_key",
+            "header": "Authorization",
+            "format": "Bearer urmi_live_<key>",
+            "alternate_header": "X-Api-Key",
+        },
+        "request_body": {
+            "template": {
+                "type": "string",
+                "required": True,
+                "description": "Subscribed agent template slug",
+                "example": template.slug,
+            },
+            "to": {
+                "type": "string",
+                "required": True,
+                "description": "Recipient WhatsApp number with country code",
+                "example": "919149154337",
+            },
+            "customer_name": {
+                "type": "string",
+                "required": True,
+                "description": "Recipient name shown in the template body",
+                "example": "Suyash",
+            },
+            "report_id": {
+                "type": "string",
+                "required": False,
+                "description": "Report id suffix for the dynamic View Report button URL",
+                "example": "run-abc123",
+            },
+        },
+        "responses": {
+            "200": {
+                "description": "WhatsApp template accepted by Meta",
+                "example": {
+                    "success": True,
+                    "template": template.slug,
+                    "to": "919149154337",
+                    "customer_name": "Suyash",
+                    "report_id": "run-abc123",
+                    "report_url": f"{template.button_url_base or ''}run-abc123",
+                    "wa_message_id": "wamid.HBg...",
+                    "dispatch_id": "00000000-0000-0000-0000-000000000001",
+                },
+            },
+            "401": {"description": "Missing or invalid API key"},
+            "403": {"description": "Template not subscribed"},
+            "429": {"description": "Console test limit (console only)"},
+            "502": {"description": "Meta WhatsApp API error"},
+        },
+        "notes": [
+            "Subscribe to agent templates in Console → Agent → UrmiAI before calling this API.",
+            "Urmi acts as the WhatsApp tech provider and sends from the Urmi AI WABA.",
+        ],
+        "available_templates": [
+            {
+                "slug": template.slug,
+                "name": template.name,
+                "meta_template_name": template.meta_template_name,
+            }
+        ],
+    }
+
+
+@router.get("/messages/docs/send")
+def send_agent_message_docs(db: Session = Depends(get_db)) -> dict:
+    template = db.scalar(
+        select(AgentMessageTemplate)
+        .where(AgentMessageTemplate.is_active.is_(True))
+        .order_by(AgentMessageTemplate.created_at.asc())
+    )
+    if not template:
+        return {"id": "send-agent-message", "method": "POST", "path": "/api/v1/agent/messages/send"}
+    return _explorer_doc_for_template(template)
+
+
+@router.post("/messages/send")
+async def send_agent_message(
+    payload: SendAgentMessagePayload,
+    db: Session = Depends(get_db),
+    user: UserAccount = Depends(current_api_user),
+) -> dict:
+    return await send_agent_template_message(db, user, payload, source="api")