VChata API Quickstart

This guide will help you make your first API call to VChata and create your first AI-powered social media campaign.

Prerequisites

Before you begin, you’ll need:

A VChata account (Sign up here)
Your API credentials
Basic knowledge of HTTP requests and JSON

Step 1: Get Your API Credentials

Sign up for VChata at app.vchata.com
Create an organization and complete the onboarding process
Navigate to Settings > API Keys in your dashboard
Generate a new API key and copy it securely

Keep your API key secure and never expose it in client-side code or public repositories.

Step 2: Make Your First API Call

Let’s start by getting information about your organization:

curl -X GET "https://api.vchata.com/organizations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

const response = await fetch('https://api.vchata.com/organizations', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const organizations = await response.json();
console.log(organizations);

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.vchata.com/organizations', headers=headers)
organizations = response.json()
print(organizations)

Connect a Facebook or Instagram account to start automating:

curl -X POST "https://api.vchata.com/social/connect" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "FACEBOOK",
    "accessToken": "YOUR_FACEBOOK_ACCESS_TOKEN",
    "platformUserId": "YOUR_FACEBOOK_USER_ID",
    "platformUserName": "Your Page Name"
  }'

const socialAccount = await fetch('https://api.vchata.com/social/connect', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    platform: 'FACEBOOK',
    accessToken: 'YOUR_FACEBOOK_ACCESS_TOKEN',
    platformUserId: 'YOUR_FACEBOOK_USER_ID',
    platformUserName: 'Your Page Name'
  })
});

const result = await socialAccount.json();
console.log('Connected account:', result);

Step 4: Create Your First AI Agent

Now let’s create an AI agent that can automatically respond to comments and messages:

curl -X POST "https://api.vchata.com/ai/agents/org_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Bot",
    "description": "AI agent for handling customer inquiries",
    "channels": ["DIRECT_MESSAGE", "COMMENT"],
    "autoResponse": true,
    "responseDelay": 30,
    "promptTemplateId": "template_123"
  }'

const aiAgent = await fetch('https://api.vchata.com/ai/agents/org_abc123', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Customer Support Bot',
    description: 'AI agent for handling customer inquiries',
    channels: ['DIRECT_MESSAGE', 'COMMENT'],
    autoResponse: true,
    responseDelay: 30,
    promptTemplateId: 'template_123'
  })
});

const agent = await aiAgent.json();
console.log('Created AI agent:', agent);

Step 5: Create a Campaign

Set up your first automated campaign:

curl -X POST "https://api.vchata.com/campaigns/org_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Sale Campaign",
    "description": "Automated responses for summer sale inquiries",
    "pipelineId": "pipeline_123",
    "platform": "FACEBOOK",
    "socialAccountIds": ["social_123"],
    "keywords": [
      {
        "keyword": "summer sale",
        "matchType": "CONTAINS",
        "priority": 1
      }
    ]
  }'

const campaign = await fetch('https://api.vchata.com/campaigns/org_abc123', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Summer Sale Campaign',
    description: 'Automated responses for summer sale inquiries',
    pipelineId: 'pipeline_123',
    platform: 'FACEBOOK',
    socialAccountIds: ['social_123'],
    keywords: [
      {
        keyword: 'summer sale',
        matchType: 'CONTAINS',
        priority: 1
      }
    ]
  })
});

const result = await campaign.json();
console.log('Created campaign:', result);

Next Steps

Congratulations! You’ve successfully: ✅ Made your first API call
✅ Connected a social media account
✅ Created an AI agent
✅ Set up an automated campaign

Explore the API Reference

Dive deeper into all available endpoints and features.

Set up Webhooks

Learn how to receive real-time notifications about social media events.

JavaScript SDK

Use our official SDK for easier integration.

Authentication Guide

Learn about JWT tokens, rate limits, and security best practices.

Need Help?

Documentation: Browse our complete API reference
Support: Email us at support@vchata.com
Community: Join our Discord server
Status: Check our status page

Getting Started

Core Concepts

Integrations

SDKs & Libraries

API Quickstart

VChata API Quickstart

Prerequisites

Step 1: Get Your API Credentials

Step 2: Make Your First API Call

Step 4: Create Your First AI Agent

Step 5: Create a Campaign

Next Steps

Explore the API Reference

Set up Webhooks

JavaScript SDK

Authentication Guide

Need Help?

​VChata API Quickstart

​Prerequisites

​Step 1: Get Your API Credentials

​Step 2: Make Your First API Call

​Step 3: Connect a Social Media Account

​Step 4: Create Your First AI Agent

​Step 5: Create a Campaign

​Next Steps

Explore the API Reference

Set up Webhooks

JavaScript SDK

Authentication Guide

​Need Help?

VChata API Quickstart

Prerequisites

Step 1: Get Your API Credentials

Step 2: Make Your First API Call

Step 3: Connect a Social Media Account

Step 4: Create Your First AI Agent

Step 5: Create a Campaign

Next Steps

Need Help?