{"id":15387891,"url":"https://github.com/mishushakov/dialogflow-sendgrid","last_synced_at":"2025-10-24T21:39:39.858Z","repository":{"id":97807805,"uuid":"232090934","full_name":"mishushakov/dialogflow-sendgrid","owner":"mishushakov","description":"📮 Dialogflow + Sendgrid = AI Mailbox","archived":false,"fork":false,"pushed_at":"2020-06-05T14:03:19.000Z","size":44,"stargazers_count":34,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-24T21:39:36.565Z","etag":null,"topics":["chatbot","dialogflow","dialogflow-v2","email","sendgrid"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mishushakov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://paypal.me/ushakovhq"}},"created_at":"2020-01-06T11:54:45.000Z","updated_at":"2025-07-26T08:42:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"181aa009-0ec6-451c-ad92-dad022130a55","html_url":"https://github.com/mishushakov/dialogflow-sendgrid","commit_stats":{"total_commits":17,"total_committers":1,"mean_commits":17.0,"dds":0.0,"last_synced_commit":"d81280e45e856bd2fad39db32879681252fb9584"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mishushakov/dialogflow-sendgrid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishushakov%2Fdialogflow-sendgrid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishushakov%2Fdialogflow-sendgrid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishushakov%2Fdialogflow-sendgrid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishushakov%2Fdialogflow-sendgrid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mishushakov","download_url":"https://codeload.github.com/mishushakov/dialogflow-sendgrid/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishushakov%2Fdialogflow-sendgrid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280872016,"owners_count":26405606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatbot","dialogflow","dialogflow-v2","email","sendgrid"],"created_at":"2024-10-01T14:54:53.666Z","updated_at":"2025-10-24T21:39:39.835Z","avatar_url":"https://github.com/mishushakov.png","language":"Python","funding_links":["https://paypal.me/ushakovhq"],"categories":[],"sub_categories":[],"readme":"# Dialogflow Sendgrid\n\nMail your Dialogflow Agents with Sendgrid\n\nFor features and drawbacks, see the [original repo](https://github.com/mishushakov/dialogflow-inbox)\n\n## Schema\n\n![](https://i.imgur.com/CgnAVrU.png)\n\n## Setup\n\n### Preparation\n\n1. Connect your Agents to a Dialogflow Gateway implementation ([more here](https://github.com/mishushakov/dialogflow-gateway-docs))\n2. [Make a SendGrid account](https://app.sendgrid.com/login)\n3. Visit \"Settings\" \u003e \"Sender Authentication\" and \"Authenticate Your Domain\":\n\n   ![](https://i.imgur.com/lYuGzes.png)\n\n4. Verify your DNS records:\n\n   ![](https://i.imgur.com/fZMNRGW.png)\n\n5. Go to \"API Keys\" and generate API Key with full access to \"Mail Send\":\n\n    ![](https://i.imgur.com/02UDY86.png)\n\n6. Install Dialogflow Sendgrid (below) and add \"Inbound Parse\" entry in \"Settings\" with following options:\n\n    ![](https://i.imgur.com/yhB0b5H.png)\n\n    - Receiving Domain: your domain\n    - Destination URL: endpoint to Dialogflow Sendgrid\n    - Check incoming emails for spam: up to you\n    - POST the raw, full MIME message: yes (check)\n\n### Installation\n\n#### Kubernetes\n\nSee [k8s](k8s) for examples\n\n#### Manual\n\n1. Python should be installed on the target\n2. Install the requirements with `pip install -r requirements.txt`\n3. Run `python inbox.py`\n\n### Configuration\n\n| Environment Variable | Description                                                   | Value                        |\n|----------------------|---------------------------------------------------------------|------------------------------|\n| INBOX_USER           | Sendgrid user                                                 | apikey                       |\n| INBOX_PASSWORD       | Sendgrid API Key                                              | -                            |\n| INBOX_HOST           | SMTP and IMAP server hostname                                 | smtp.sendgrid.net            |\n| FALLBACK_LANG        | Fallback language if language detection fails                 | en                           |\n| CATCHALL             | Catch-all address                                             | -                            |\n| ENDPOINT             | Dialogflow Gateway Endpoint. `*` for wildcard                 | https://*.core.ushaflow.io   |\n| DEBUG                | Debug mode                                                    | true                         |\n| PORT                 | Listen on port                                                | 5000                         |\n\n### Testing\n\nSend a test mail to a agent in the following format: your-google-cloud-project-id@yourdomain","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmishushakov%2Fdialogflow-sendgrid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmishushakov%2Fdialogflow-sendgrid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmishushakov%2Fdialogflow-sendgrid/lists"}