Skip to main content

Developer Guides

Comprehensive guides for building AI-powered conversational services with the WIIL SDKs.


Quick Start

GuideDescription
Dynamic Agent SetupRecommended - Deploy AI agents with a single API call
Fundamental ConfigurationTraditional multi-step setup for fine-grained control

Channels

Guides for setting up communication channels.

GuideDescription
Understanding ChannelsChannel types and architecture
Web ChannelsWeb chat widget integration
Voice ChannelsPhone call integration
SMS ChannelsText messaging integration
Phone PurchasePurchasing phone numbers
TroubleshootingCommon channel issues

Business Services

Guides for managing business operations and transactions.

GuideDescription
Services & AppointmentsAppointment booking and scheduling
Menus & OrdersRestaurant menu and food orders
Products & OrdersRetail products and order management
ReservationsResource reservations (tables, rooms)
Property ManagementReal estate listings and inquiries

Communications

Guides for outbound messaging across email, SMS, and AI voice calls.

GuideDescription
Messaging Quick StartSend calls, SMS, and email in minutes
Outbound CommunicationsTemplates, status tracking, architecture, and best practices

Data & Security

Working responsibly with customer information and transactions.

GuideDescription
Handling Customer DataAccess model, keeping API keys server-side, and collecting information responsibly

Service Management

Guides for configuring platform services.

GuideDescription
Instruction ConfigsAgent behavior and guidelines
Agent ConfigsAgent and model configuration
Deployment ChannelsChannel setup
Deployment ConfigsDeployment configuration
Provisioning ConfigsSTT/TTS provisioning chains
Translation SessionsTranslation configuration
Support ModelsAI model registry
Knowledge SourcesKnowledge base setup
Telephony ProviderPhone provider configuration

Troubleshooting

Diagnosing and fixing common agent issues.

GuideDescription
Agent TroubleshootingWhy a chat agent won't work — capabilities without catalogs, information-only agents, and deployment URL mismatches

Configuration Flow

Organization
└─→ Project
├─→ Instruction Configuration (agent behavior)
├─→ Agent Configuration (model + instructions)
├─→ Deployment Channel (WEB, CALLS, SMS)
└─→ Deployment Configuration (agent + channel → live)

Getting Started

  1. Sign up at console.wiil.io
  2. Generate an API key in SettingsAPI Keys
  3. Install the SDK: npm install wiil-js or pip install wiil-python
  4. Start with the Dynamic Agent Setup Guide