+ z j ^RIHt^RIHt]!R.R7t]P R]R7RRl4t]P R ]R7R R l4tR R ltR#)) APIRouter) HTMLResponse installation)tagsz/freshworks/app)response_classc$V^8dQhR\/#returnstr)formats"app\routers\install.py __annotate__rs#c\4#N _page_htmlrrapp_pager <rz/freshworks/app/installc$V^8dQhR\/#r r )rs"rrr scrc\4#rrrrr install_pager rrc$V^8dQhR\/#r r )rs"rrrsPPCPrcR#)a 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.

rrrrrrsO rN) fastapirfastapi.responsesrroutergetrrrrrrr"sc* ( ) l;< %lCDPr