Setup Guide

Configure your environment variables to enable all integrations for the Drizzle Marketing AI Agent.

Webhook Configuration

To enable real-time processing of Fireflies meetings, configure the webhook in your Fireflies dashboard:

  1. Go to Fireflies Webhook Settings
  2. Add webhook URL: https://your-domain.vercel.app/api/webhooks/fireflies
  3. Subscribe to event: transcript.completed
  4. Generate a webhook secret and add it to your environment variables as FIREFLIES_WEBHOOK_SECRET

Database Setup

Required

Your Neon database is already connected. Run the initial schema script to create the necessary tables.

Script to run:

scripts/001_initial_schema.sql

This script will create all required tables for meetings, decisions, action items, Jira tasks, and more.

Cron Job Security

Recommended

The CRON_SECRET is used to secure your automated cron job endpoint. While optional, it's highly recommended to prevent unauthorized access to your agent's scheduled runs.

CRON_SECRET

A secure random string that Vercel Cron will use to authenticate with your endpoint.

Generate Secure Secret:

How Vercel Cron Works with the Secret:

  1. Add CRON_SECRET to your Vercel project environment variables
  2. Vercel automatically includes this as a Bearer token in cron requests
  3. Your endpoint verifies the token matches before processing
  4. This prevents unauthorized users from triggering the agent manually

Note: If you don't set CRON_SECRET, the cron endpoint will still work but won't verify authentication.

After adding to Vercel, the cron job will run daily at 9 AM on weekdays (Monday-Friday) as configured in vercel.json.

fireflies

FIREFLIES_API_KEYRequired

API key from Fireflies.ai for accessing meeting transcripts

Get your api key
FIREFLIES_WEBHOOK_SECRETOptional

Webhook secret for verifying Fireflies webhook requests (optional but recommended for security)

Get your text

google drive

Easy Refresh Token Setup

Use our built-in authorization flow to easily get your Google refresh token. This tool will guide you through the OAuth process step-by-step.

Get Google Refresh Token

Make sure you've added GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET to your environment variables first.

GOOGLE_DRIVE_CLIENT_IDRequired

OAuth 2.0 Client ID from Google Cloud Console

Get your text
GOOGLE_DRIVE_CLIENT_SECRETRequired

OAuth 2.0 Client Secret from Google Cloud Console

Get your text
GOOGLE_DRIVE_REFRESH_TOKENRequired

OAuth 2.0 Refresh Token (generate using OAuth playground)

Get your text

jira

JIRA_DOMAINRequired

Your Jira domain (e.g., yourcompany.atlassian.net)

Get your url
JIRA_EMAILRequired

Email address associated with your Jira account

JIRA_API_TOKENRequired

API token from Jira (Settings > Security > API tokens)

Get your api key
JIRA_PROJECT_KEYOptional

Jira project key where tasks will be created (default: MKTG)

slack

SLACK_BOT_TOKENRequired

Bot User OAuth Token from Slack App (starts with xoxb-)

Get your api key
SLACK_SIGNING_SECRETRequired

Signing Secret from Slack App for verifying webhook requests

Get your text
SLACK_CHANNEL_IDRequired

Channel ID where the agent will post updates (e.g., C123456789)

Adding Environment Variables

You can add environment variables directly in the v0 UI:

  1. Click the sidebar icon in the chat
  2. Navigate to "Vars" section
  3. Add each environment variable with its corresponding value
  4. Or add them in your Vercel project settings under Settings → Environment Variables when you deploy

Next Steps

  1. Run the database schema script
  2. Configure all required environment variables
  3. Set up Fireflies webhook
  4. Test each integration using the test endpoints
  5. Return to the dashboard to monitor agent activity