​

Installation & Configuration

​

1) Install the service

• Install the Odoo modules and the Twilio Audio Interface service from connect_elevenlabs/service.
• Copy and fill the environment file, then install dependencies and run:

cd service
cp .env.example .env
cat .env  # set ELEVENLABS_API_KEY, ODOO_USER, ODOO_PASSWORD, ODOO_URL
uv sync
uv run main.py

• In Odoo, set a password for the connect portal user (remove the Internal Users filter to see it) and reuse it in .env.

​

2) Expose the service with ngrok

• Create an ngrok account, install the CLI, and add your auth token:

ngrok config add-authtoken <token>
ngrok http 48000

​

3) Agent URL in Connect

​

4) Post-call webhook from Odoo

​

5) Create webhook in ElevenLabs

​

6) Store webhook secret in Odoo

​

7) Run in production with systemd

​

Ngrok service

[Unit]
Description=Ngrok tunnel for ElevenLabs agent
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
WorkingDirectory=/opt/connect-elevenlabs/service
ExecStart=/usr/bin/env ngrok http 48000
Restart=on-failure
User=odoo

[Install]
WantedBy=multi-user.target

​

Agent service

[Unit]
Description=ElevenLabs agent for Oduist Connect
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
WorkingDirectory=/opt/connect-elevenlabs/service
EnvironmentFile=/opt/connect-elevenlabs/service/.env
ExecStart=/usr/bin/env uv run main.py
Restart=on-failure
User=odoo

[Install]
WantedBy=multi-user.target

​

Enable and monitor

sudo systemctl daemon-reload
sudo systemctl enable --now ngrok-elevenlabs.service elevenlabs-agent.service
sudo journalctl -u ngrok-elevenlabs.service -u elevenlabs-agent.service -f

​

Other HTTPS tunnel options

• Cloudflare Tunnel (Argo): free tier, custom domain, TLS handled by Cloudflare; no inbound ports needed.
• Tailscale Funnel: quick HTTPS from a private node; good for internal services with short-lived public URLs.
• Caddy or Nginx reverse proxy + Let’s Encrypt: terminate TLS on your own server/static IP or VPS.
• Traefik: dynamic reverse proxy with auto-cert via ACME and service discovery (Docker/K8s friendly).
• frp (Fast Reverse Proxy): self-hosted tunnel; run your own frps server and frpc client.
• LocalTunnel or Pagekite: lightweight OSS tunnels for quick testing (not ideal for production).