conviro-cookbook

Working examples for Conviro. Embed snippets, API clients, webhook receivers, and CRM bridges — copy what you need, edit the env vars, run it.

Everything in here is meant to be run, not read.

What's inside

• widget-embed/ — drop-in chat widget for plain HTML, React, Next.js App Router, WordPress, WooCommerce, Shopify, and Magento 2.
• api/ — REST API clients in curl, Node, Python, PHP, and Go. Five endpoints covered: sessions, messages, knowledge base, contacts, analytics.
• webhooks/ — signed inbound webhook receivers for Node/Express, PHP, Python/Flask, and Next.js Route Handlers.
• crm/ — recipes that pipe Conviro events into HubSpot, Pipedrive, Airtable, Notion, and Google Sheets.
• automations/ — drop-in workflows for n8n (HubSpot lead sync, CSAT to sheets, Slack escalation, Jira on AI failures, Woo product → KB).
• docs/ — short guides on webhook signing, API keys/scopes, and CRM field mapping.

Prerequisites

You'll need a Conviro account and an API key. Create one at app.conviro.io/dashboard/settings/api-keys. For widget embedding you don't need an API key — just the publicKey from your widget channel.

Conventions

• Every example reads secrets from environment variables. None of them hard-code keys.
• Each subfolder has its own README.md with the minimum to get it running. No global setup step.
• The Node and Python webhook examples both verify the X-Webhook-Signature header. Don't skip that step in production.

Reporting issues

If a snippet doesn't run, open an issue with the folder name and the error. Pull requests welcome — but please test the change against a real Conviro tenant before sending it.

— Hasan / useconviro.com