from fastapi import APIRouter from fastapi.responses import HTMLResponse router = APIRouter(tags=["installation"]) @router.get("/freshworks/app", response_class=HTMLResponse) def app_page() -> str: return _page_html() @router.get("/freshworks/app/install", response_class=HTMLResponse) def install_page() -> str: return _page_html() def _page_html() -> str: return """ MacroBase Freshchat API

MacroBase Freshchat API

Integracion backend para Freshchat/Freshworks con menus interactivos, botones, listas y flujos de encuesta.

Estado esperado: API publicada y lista para recibir eventos de Freshchat.

Healthcheck: /health

Eventos: /freshchat/events/conversation y /freshchat/events/message

Uso Recomendado

Para botones reales en WhatsApp se debe instalar la Custom App privada de Freshworks incluida en el proyecto. La Custom App escucha eventos de conversacion y reenvia el payload completo a esta API.

Variables Requeridas En FastAPI

APP_ENV=production
FRESHCHAT_API_TOKEN=token-interno
FRESHWORKS_API_BASE_URL=https://api.freshchat.com
FRESHWORKS_API_TOKEN=token-oficial-freshchat
FRESHWORKS_DEFAULT_ACTOR_TYPE=bot
FRESHWORKS_ASSUME_IDENTITY=false

Custom App

Subir el archivo freshworks_custom_app.zip en Freshworks Developer Portal como Custom App.

Parametros de instalacion:

api_base_url = URL publica de esta API
api_token = FRESHCHAT_API_TOKEN

External App

External App sirve como ficha o pagina de instalacion. No reemplaza la Custom App si necesitas escuchar eventos y enviar botones automaticos.

"""