IceCore API Documentation

Getting Started

Quick Start Guide - Get up and running in 5 minutes

• Authentication - API keys, permissions, security

WhatsApp APIs

• Bulk Send - Send marketing campaigns to thousands
• Templates - Manage message templates
• Flows - Interactive forms and surveys

Integration

• Webhooks - Real-time event notifications
• REST API - Conversations, messages, analytics

🚀 Popular Use Cases

1. Marketing Campaigns

Send bulk WhatsApp messages for promotions, announcements, updates.

POST /api/whatsapp/bulk-send

→ Bulk Send Guide

2. Real-Time Alerts

Get notified instantly when customers are unhappy.

POST /api/webhooks
Subscribe to: csat.low

→ Webhooks Guide

3. CRM Integration

Pull conversation data into your CRM or BI tools.

GET /api/v1/conversations
GET /api/v1/analytics

→ REST API Reference

4. Interactive Surveys

Collect structured data via WhatsApp Flows.

POST /api/whatsapp/flows

→ Flows Guide

🔐 Security

• API Keys: SHA-256 hashed, never stored in plain text
• Webhooks: HMAC-SHA256 signatures for verification
• Rate Limiting: Configurable per key
• Workspace Isolation: You only access your own data

📊 API Features

Feature	Endpoint	Auth Method
List Conversations	/api/v1/conversations	API Key
Send Messages	/api/v1/messages/send	API Key
Get Analytics	/api/v1/analytics	API Key
Bulk Send WhatsApp	/api/whatsapp/bulk-send	Session Cookie
Manage Templates	/api/whatsapp/templates	Session Cookie
Send Flows	/api/whatsapp/flows	Session Cookie
Setup Webhooks	/api/webhooks	Session Cookie

Note:

• /api/v1/* endpoints use API Key authentication (for external integrations)
• /api/whatsapp/* and /api/webhooks use Session Cookie (from IceCore dashboard)

🎯 Quick Examples

Send Bulk Campaign (from code)

const response = await fetch('https://icecore.ai/api/whatsapp/bulk-send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cookie': 'your_session_cookie'
  },
  body: JSON.stringify({
    workspaceId: 'workspace-uuid',
    templateName: 'order_update',
    recipients: [
      { phone: '+77001234567', variables: { name: 'Aibek' } }
    ]
  })
});

Get Conversations (external system)

const response = await fetch('https://icecore.ai/api/v1/conversations?status=open', {
  headers: {
    'Authorization': 'Bearer sk_live_abc123...'
  }
});

Setup Webhook (from dashboard)

const response = await fetch('https://icecore.ai/api/webhooks', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cookie': 'your_session_cookie'
  },
  body: JSON.stringify({
    workspaceId: 'workspace-uuid',
    url: 'https://your-server.com/webhooks',
    events: ['conversation.resolved', 'csat.low']
  })
});

📞 Support

• Email: support@icecore.ai
• Documentation: https://icecore.ai/docs
• Status Page: https://status.icecore.ai
• Community: https://community.icecore.ai

📝 Changelog

2025-10-30

• ✅ WhatsApp Bulk Send API (Graph API v24)
• ✅ WhatsApp Templates Management
• ✅ WhatsApp Flows Support
• ✅ Webhooks System (11 event types)
• ✅ Public REST API (v1)
• ✅ API Key Authentication
• ✅ Campaign History Tracking

---

🎓 Tutorials

• Send Your First Campaign
• Setup Slack Alerts for Low CSAT
• Integrate with Your CRM
• Build a Custom Dashboard

---

Ready to start? → Quick Start Guide