Docs/Plugins/Odoo

Apertur Photo Collection for Odoo

The Apertur plugin for Odoo adds QR-based photo capture to any contact, task or helpdesk ticket. Generate a session in one click, share the QR code with the customer or technician, and receive photos directly on the record — with chatter notification and signed-webhook delivery.

At a glance

Supported Odoo versions

16.0 · 17.0 · 18.0 · 19.0

License

LGPL-3

Technical name

apertur_connect

Distribution

Free on the Odoo Apps store

Free tier — no credit card

Apertur is a SaaS service. The free plan covers most pilot deployments:

15 sessions per month
10 images per session, up to 5 MB each
12-hour session expiry
1 active destination

Paid plans (Starter, Pro, Business, Unlimited) unlock higher limits, password-protected sessions, custom branding and end-to-end encryption. See pricing.

Installation

Install Apertur Photo Collection from the Odoo Apps store directly in your Odoo instance, or copy the module folder to your addons path.

In Odoo, open Apps.
Remove the "Apps" filter, search for Apertur.
Click Install on Apertur Photo Collection.

Self-hosted Odoo

If you self-host Odoo, copy the apertur_connectfolder into your addons path, restart Odoo, and update the apps list. The Python package requests must be available.

Configuration

Create an Apertur account at apertur.ca (free tier available).
Generate an API key in your dashboard. Keys prefixed with aptr_test_ hit the sandbox; aptr_live_ keys hit production.
In Odoo, go to Settings → Apertur, paste the API key and choose a webhook secret (a long random string).
Copy the webhook URL shown in settings (https://<your-odoo>/apertur/webhook) and add it as a destination on the Apertur dashboard.

Usage

Open any contact, task or helpdesk ticket. The Apertur tab shows a Collect Photos button. Click it to create a session bound to that record.

Share the QR code (printed, emailed or displayed on screen). The recipient scans it on a mobile device, uploads photos from the camera or gallery, and each image is delivered back to the record as an ir.attachment with a chatter notification.

Session modes:

contact — QR sent to the contact, public upload page.
internal — QR used by an internal user (technician, agent).
public — unauthenticated upload (e.g. printed leaflets).

Webhook

The plugin exposes /apertur/webhook. Each request is verified using HMAC-SHA256 with the webhook secret configured in settings; mismatched signatures are rejected. Verified events trigger:

Download of the uploaded image from Apertur.
Creation of an ir.attachment on the linked record.
A chatter message on the record.

See Webhook signatures for the signature scheme details.

Data & privacy

The plugin is a thin integration with Apertur’s SaaS API. Only the entity reference (model name + record id) and your API key are sent to https://api.apertur.ca when creating a session.

Uploaded photos are stored temporarily on Apertur’s infrastructure, delivered to your Odoo instance via signed webhook, and then deleted. You retain full ownership of your data and can delete it from your Apertur dashboard at any time. No analytics or telemetry are sent from this module.

Troubleshooting

The Apertur tab doesn’t appear.: Make sure the module is installed and the user belongs to a group with read access to apertur.session. Refresh the browser (Ctrl+Shift+R) to flush the OWL asset cache.
Webhook returns 401.: The HMAC signature didn’t match. Check that the secret in Settings → Apertur is identical to the one on the Apertur destination. Recreate the destination if in doubt.
Images don’t appear after upload.: Verify that your Odoo instance is reachable from the public internet (Apertur needs to POST to /apertur/webhook). Local http://localhost URLs won’t work in production. Use an HTTPS tunnel (Cloudflare Tunnel, ngrok) for dev environments.
"requests is not available" on install.: The Python requests package is missing from your Odoo environment. Run pip install requests inside the Odoo virtualenv and restart.

Support

Bug reports and feature requests: support@apertur.ca.