middleware-sendmessage-holos 0.2.2

Middleware FastAPI para webhooks de Kommo

middleware-sendmessage-holos

Middleware FastAPI para recibir webhooks de Kommo, procesar mensajes y actualizar leads.

Instalacion rapida

pip install git+https://github.com/<tu-org>/middleware_panama.git

Si trabajas dentro del repo:

pip install -e .

Uso

El paquete expone el comando:

middleware-sendmessage-holos

Eso levanta el servidor en 0.0.0.0 y usa PORT si esta definida, o 8080 por defecto.

Tambien puedes ejecutar el modulo directamente:

python -m middleware_sendmessage_holos

Variables de entorno

• TOKEN_KOMMO
• SUBDOMAIN_KOMMO
• OPENAI_API_KEY
• KOMMO_MESSAGE_FIELD_ID (default: 955666)
• KOMMO_ALLOWED_PIPELINE_IDS (csv, default: 12109475)
• KOMMO_ALLOWED_STATUS_IDS (csv, default: 93482383,93482379)
• PORT opcional

Con esto puedes replicar el proyecto para otro cliente sin tocar codigo, solo cambiando .env.

Nota

requirements.txt sigue siendo la fuente de dependencias del proyecto. El paquete pip las instala automaticamente al usar pip install . o pip install -e ..

Publicacion en PyPI (publico)

El paquete esta preparado para publicarse cuando hagas push de un tag que empiece con v, por ejemplo:

git tag v0.2.2
git push origin v0.2.2

El workflow de GitHub Actions construye el paquete y lo publica en PyPI publico.

Antes de ejecutar el workflow, crea este secret en el repositorio:

• PYPI_API_TOKEN: token de PyPI (formato pypi-...) con permiso para publicar

Puedes generarlo en PyPI desde Account settings > API tokens.

Instalacion desde PyPI

Cuando una version este publicada, el equipo instala asi:

pip install middleware-sendmessage-holos

Proyecto ejemplo usando el paquete

Se incluye una plantilla completa y replicable en:

• examples/holos_consumer_project

Esa plantilla monta el middleware en /webhooks/holos/add_message y solo requiere cambiar variables en .env.