Documentation

Everything you need to get started with Djaber.ai

Getting Started

Welcome to Djaber.ai! This guide will help you set up your AI agent in minutes.

Quick Setup

  1. 1
    Create an account

    Sign up for free and verify your email

  2. 2
    Connect your pages

    Link Facebook and Instagram via OAuth

  3. 3
    Train your AI

    Upload FAQs and customize responses

Connect Your Pages

Connecting your social media pages is simple and secure using OAuth authentication.

Facebook & Instagram

  • Navigate to Settings and click Connect Pages
  • Log in to Facebook and grant permissions
  • Select which pages you want to connect

Train Your AI

Customize your AI to match your brand voice and product knowledge.

Brand Voice

Define how your AI should communicate - formal, casual, friendly, professional, etc.

Example:

"Always be friendly and use casual language. Include emojis when appropriate."

FAQ Library

Upload common questions and answers to help AI respond accurately.

Support CSV, JSON, or manual entry

Product Catalog

Import your products so AI can answer questions about pricing, availability, and features.

Manage Conversations

Monitor and manage all customer conversations from your dashboard.

Real-time Monitoring

See all conversations as they happen across all connected pages.

  • Live message feed
  • Filter by page, status, or sentiment
  • Search conversation history

Human Takeover

Step in anytime to handle conversations manually.

When to take over:

  • • Complex technical questions
  • • Upset or frustrated customers
  • • Custom pricing negotiations
  • • Refund or complaint handling

Analytics

Track performance metrics and gain insights into customer interactions.

Key Metrics

  • Response TimeAverage
  • Resolution RatePercentage
  • Customer SatisfactionCSAT Score
  • Messages HandledTotal Count

Sentiment Analysis

Understand customer emotions and satisfaction levels.

Positive
Neutral
Negative

API Reference

Integrate Djaber.ai into your existing systems with our REST API.

Authentication

All API requests require authentication using an API key in the header.

Authorization: Bearer YOUR_API_KEY

Endpoints

Send Message

POST /api/v1/messages
POST

Send a message to your AI agent programmatically.

Request Body:

{
  "page_id": "123456789",
  "recipient_id": "user_123",
  "message": "Hello, how can I help?"
}

Get Conversations

GET /api/v1/conversations
GET

Retrieve all conversations for a specific page.

Query Parameters:

page_id (required): string
limit (optional): number (default: 50)
offset (optional): number (default: 0)

Update AI Training

PUT /api/v1/training
PUT

Update your AI training data, FAQs, or brand voice.

Request Body:

{
  "page_id": "123456789",
  "brand_voice": "Friendly and casual",
  "faqs": [
    {
      "question": "What are your hours?",
      "answer": "We're open 9am-5pm Mon-Fri"
    }
  ]
}

Get Analytics

GET /api/v1/analytics
GET

Retrieve analytics and metrics for your pages.

Response:

{
  "total_messages": 1234,
  "avg_response_time": 0.8,
  "satisfaction_score": 4.5,
  "resolution_rate": 0.92
}

Rate Limits

  • Standard: 100 requests per minute
  • Pro: 1,000 requests per minute
  • Enterprise: Custom limits

Webhooks

Receive real-time notifications when events occur.

Available Events:

  • message.receivedNew message from customer
  • message.sentAI sent a response
  • conversation.escalatedConversation needs human attention

Need more help? Contact our support team