Back to Home
Documentation

Everything you need
to get started.

From installation to advanced configuration — all in one place.

Quick Start

Get your chat widget live in under 60 seconds. No developers needed.

1
Sign up at janimony.chat/signup — no credit card needed.
2
Copy your API key from your dashboard after signup.
3
Paste the code snippet into your website before the </body> tag.

Install the Widget

Paste this code before the closing </body> tag on any page where you want the chat to appear:

HTML
<!-- Janimony Chat Widget -->
<script src="https://cdn.janimony.chat/widget.js"></script>
<script>
  JanimonyChat.init({
    businessId: 'your_api_key_here'
  });
</script>
Your businessId is your unique API key from your dashboard. Keep it safe — do not share it publicly.

Configuration Options

Customise the widget appearance on init:

JavaScript
JanimonyChat.init({
  businessId:     'jmc_xxxxx',   // Required
  primaryColor:   '#000000',   // Optional
  secondaryColor: '#FFFFFF'    // Optional
});
OptionTypeRequiredDescription
businessIdstringRequiredYour API key from the dashboard
primaryColorstringOptionalWidget header + button colour (default: #000000)
secondaryColorstringOptionalText on primary backgrounds (default: #FFFFFF)

Custom Colour Examples

JavaScript
// Purple theme
JanimonyChat.init({ businessId: 'jmc_xxx', primaryColor: '#667eea' });

// Green theme
JanimonyChat.init({ businessId: 'jmc_xxx', primaryColor: '#10b981' });

// Custom text colour
JanimonyChat.init({ businessId: 'jmc_xxx', primaryColor: '#f59e0b', secondaryColor: '#111827' });
You can also set colours permanently from Settings → Widget in your dashboard — no code changes needed.

POST /api/chat

Send a customer message and receive an AI response.

JSON — Request
{
  "businessId": "jmc_xxxxx",
  "sessionId":  "sess_123456_abc",
  "message":    "Hello, I need help",
  "mode":       "ai"
}
JSON — Response
{
  "success":   true,
  "reply":     "Hi! How can I help?",
  "sessionId": "sess_123456_abc"
}

POST /api/chat/request-agent

Request a human agent. Sends an email notification to the business owner (Pro & Pro+ only).

JSON — Request
{
  "businessId": "jmc_xxxxx",
  "sessionId":  "sess_123456_abc",
  "messages":   []
}

GET /api/chat/messages/:businessId/:sessionId

Retrieve all messages for a session. Used by the widget to poll for agent replies.

JSON — Response
{
  "success":        true,
  "messages":       [...],
  "agentConnected": false
}

Get Help

Stuck? We're here to help — pick the fastest channel for you.

Email Support

Send us your question and we'll respond within 24 hours.

janimony.chat@gmail.com

WhatsApp

Chat directly for faster responses and real-time support.

+234 803 936 1542

Live Chat

Use the chat widget on any Janimony page for instant help.

Go to homepage

Taking you there...