Skip to content

docs: implement Perry Webhook Addon documentation#15

Merged
aperezmarquez merged 1 commit into
mainfrom
la-ia
May 5, 2026
Merged

docs: implement Perry Webhook Addon documentation#15
aperezmarquez merged 1 commit into
mainfrom
la-ia

Conversation

@D3n3bX

@D3n3bX D3n3bX commented May 5, 2026

Copy link
Copy Markdown
Contributor

Description

This PR implements the comprehensive technical documentation for the Perry Webhook Addon, the core Odoo-side component that bridges the ERP with the Perry AI Engine.

Fixes #14

Key Technical Implementations

  • Odoo mail.message Hook: Documentation on how the module intercepts communications by overriding the method.
  • Non-Blocking Architecture: Detailed explanation of the background threading strategy () and independent database cursors used to ensure a zero-latency UI experience.
  • Intelligent Filtering & Anti-Recursion: Explained the logic used to identify private chats and prevent infinite loops (ignoring Perry's own messages).
  • Webhook Workflow: Documented the JSON payload structure and the process for committing AI responses back to the Odoo Discuss channel.
  • Observability: Details on the Logfire spans used to trace a message from the moment it is typed in Odoo until Perry responds.

This documentation ensures that the integration point between Odoo and the FastAPI ingest engine is clearly defined for future maintenance.

@aperezmarquez aperezmarquez merged commit 15351bb into main May 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation for webhook_perry

2 participants