Documentation

Learn how to set up and use RepGuy to bring your OpenAI agent workflows to mobile devices.

Getting Started

Get RepGuy running in minutes. Follow these simple steps.

  1. 1) Download the app

    Install RepGuy from the App Store on your iOS device.

  2. 2) Create an account

    Sign up or log in on repguy.dev.

    Go to Login

Create a Project

Create a project to connect your keys and workflow.

Project Requirements

  • OpenAI API Key
  • Domain API Key (for your agent workflow)
  • Workflow ID from your agent builder
Go to API Keys Setup

Steps

  1. Open the Dashboard
  2. Click New Project
  3. Add your AgentBuilder API key (encrypted at rest)
  4. Add your Domain API key
  5. Enter your Workflow ID
  6. Click Create Project

Configure your workflow

Set your API keys and workflow ID.

Mobile Pairing

Pair your phone to launch and chat on mobile.

Using a QR code

  1. Open your project on the dashboard
  2. Click Launch
  3. Scan the QR code in the app
  4. Approve the request

Security Features

  • End-to-end encrypted connections
  • Slide-to-approve authentication
  • Temporary pairing tokens
  • Automatic timeout protection

Launch and connect

Click Launch, then scan the QR code.

Approve pairing

Slide to approve on the dashboard. The app opens the chat automatically.

Tip

Keep the dashboard open while pairing. The connection times out after 1 minute.

API Keys Setup

Add two keys: AgentBuilder (service account) and Domain (allowlist).

AgentBuilder API Key

Create a service account key in OpenAI:

  1. Go to OpenAI Agent Builder
  2. Navigate to API Keys section
  3. Create a Service Account secret key
  4. Paste it into RepGuy (encrypted at rest)

Domain API Key

Allowlist your domain so RepGuy can call your workflow.

Create a domain key in OpenAI:

  1. Go to Domain Allowlist
  2. Click Add Domain and enter "https://repguy.dev/"
  3. Create the domain API key
  4. Paste it into RepGuy (encrypted at rest)

Video Guides

Watch step-by-step tutorials to get started with RepGuy quickly.

Complete Setup Tutorial

Follow along as we walk through the entire RepGuy setup process from start to finish.

What's Covered
  • Creating your first project
  • Setting up API keys securely
  • Mobile app pairing process
  • Testing your workflow
  • Best practices and tips
Quick Start

This tutorial covers everything you need to know to get RepGuy working with your OpenAI agent workflows.

Duration: ~10 minutes

MCP Server

Connect external services to your workflows using Model Context Protocol (MCP) servers. Enable your agents to interact with databases, CRMs, and other tools.

Supabase Connector

Connect your Supabase database to enable your agents to query and manipulate data.

Setup Steps

  1. Login to repguy.dev
  2. Select a workflow
  3. Scroll down to Active Services
  4. Click Add Services
  5. Choose Supabase from dropdown
  6. Fill in your connection details
postgresql://postgres:[YOUR_PASSWORD]@db.dbnvpzdqjxzpivvahaya.supabase.co:5432/postgres

Replace [YOUR_PASSWORD] with your actual database password

Your Supabase database password

After setup, click Create to activate the connector.

Go to MCP Connect

Supabase Setup Video

Watch this step-by-step video to see how to connect your Supabase database.

HubSpot Connector

Integrate with HubSpot CRM to enable your agents to manage contacts, deals, and more.

Setup Steps

  1. Login to repguy.dev
  2. Select a workflow
  3. Scroll down to Active Services
  4. Click Add Services
  5. Choose HubSpot from dropdown
  6. Click Login to authorize

Authorization Flow

You'll be redirected to HubSpot to install the RepGuy app. Once authorized, you'll be redirected back to RepGuy automatically.

After successful authorization, start using HubSpot in your AgentBuilder.

Go to MCP Connect

HubSpot Setup Video

Follow along with this video to connect your HubSpot CRM to RepGuy.

MCP Connect

Use your connected services in AgentBuilder by configuring MCP connections.

Using Connected Services

  1. Open your AgentBuilder workflow
  2. Navigate to the MCP or Tools section
  3. Select your connected service (Supabase, HubSpot, etc.)
  4. Configure the specific actions you want your agent to perform
  5. Test the connection to ensure it's working properly
Supabase Actions
  • Query database tables
  • Insert new records
  • Update existing data
  • Delete records
HubSpot Actions
  • Create and update contacts
  • Manage deals and pipelines
  • Track interactions
  • Generate reports

MCP Connect Video

Learn how to use your connected services in AgentBuilder with this comprehensive guide.

Troubleshooting

QR Code won't scan
  • Ensure your camera has permission to access the camera
  • Check that the QR code is fully visible on screen
  • Try adjusting screen brightness
  • Generate a new QR code if it has expired
Connection timeout error
  • The pairing window is only valid for 2 minutes
  • Click "Launch" again to generate a new pairing session
  • Ensure both devices are connected to the internet
  • Try refreshing the dashboard page
API key errors
  • Verify your OpenAI API key is valid and has sufficient credits
  • Check that your Domain API key matches your workflow platform
  • Ensure there are no extra spaces when pasting keys
  • Try regenerating your API keys from the source
Workflow not responding
  • Check if your workflow is active on the platform
  • Verify the Workflow ID is correct
  • Ensure your API keys have proper permissions
  • Contact support if the issue persists

Need More Help?

Our support team is here to assist you with any questions.

Contact SupportGo to Dashboard