API Reference

// Using fetch
const response = await fetch('https://api.n8chat.io/v1/message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  },
  body: JSON.stringify({
    message: 'What is your return policy?',
    session_id: 'sess_abc123',
    context: {
      page_url: window.location.href,
      user_name: 'John Doe'
    }
  })
});

const data = await response.json();
console.log(data.message);

import requests

response = requests.post(
    'https://api.n8chat.io/v1/message',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'your_api_key_here'
    },
    json={
        'message': 'What is your return policy?',
        'session_id': 'sess_abc123',
        'context': {
            'page_url': 'https://example.com',
            'user_name': 'John Doe'
        }
    }
)

data = response.json()
print(data['message'])

curl -X POST https://api.n8chat.io/v1/message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "message": "What is your return policy?",
    "session_id": "sess_abc123",
    "context": {
      "page_url": "https://example.com",
      "user_name": "John Doe"
    }
  }'

<?php
$ch = curl_init('https://api.n8chat.io/v1/message');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: your_api_key_here'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'message' => 'What is your return policy?',
        'session_id' => 'sess_abc123',
        'context' => [
            'page_url' => 'https://example.com',
            'user_name' => 'John Doe'
        ]
    ])
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
echo $data['message'];

// Open chat when a button is clicked
document.getElementById('help-button').addEventListener('click', () => {
  window.N8Chat.open();
});

// Set custom context
window.N8Chat.setContext({
  subscription_tier: 'premium',
  account_age_days: 365,
  preferred_language: 'en'
});

// Listen for messages
window.N8Chat.on('message:received', (message) => {
  console.log('AI responded:', message.content);

  // Track in analytics
  analytics.track('chat_response', {
    session_id: message.session_id,
    response_time: message.response_time_ms
  });
});

// Send a proactive message
if (cart.total > 100 && !cart.hasFreeShipping) {
  window.N8Chat.open();
  window.N8Chat.sendMessage('I see you have items in your cart!');
}