Overview

Install DotSIP, open the web admin, connect real SIP, and decide each call from your own HTTP API.

DotSIP is a program you run on your own Windows PC or Linux server. It registers SIP trunks and SIP phones, and it asks your HTTP API what to do with each incoming call. When your API says to answer, DotSIP opens a live OpenAI voice session and can call tools on your servers during the call. There is no dialplan.

The program you install is the web admin plus the SIP service. This website sells the license. It does not host your PBX, your SIP trunks, or your OpenAI account.

What you need

  • The Windows folder or the Linux x86_64 folder from your DotSIP download.
  • A license key from your DotSIP account. Without a valid key the program does not register SIP.
  • A SIP account from your carrier, and optionally IP phones or a GSM gateway that speaks SIP.
  • An HTTPS or HTTP endpoint you control. DotSIP will POST one JSON object there for every inbound call.
  • An OpenAI API key on the live model, if a call should be answered by a voice agent. Save it under Models. There is no program-wide key.

Documentation

  1. Windows or Linux
  2. First run and license
  3. SIP accounts and phones
  4. Routes
  5. Recordings and DTMF
  6. Agents and OpenAI
  7. Agent prompt
  8. Tools
  9. Tool parameters
  10. Calls, debug, and access
  11. API reference
  12. HTTP API

Examples

  1. Menu without an agent
  2. Busy line
  3. Call from an extension or a trunk
  4. Outbound call to a patient
  5. Agent books an appointment
  6. Hand off to another agent
  7. Both webhooks
  8. Queue
  9. After hours
  10. Group ringing
  11. Example: switchboard
  12. Example: appointments

Admin address

The admin is HTTPS on port 9080 by default. The exact URL, including the address of this machine, is written to data/admin.url when the program starts. The certificate is created on first start and is self-signed, so the browser warns you the first time. That warning is expected on your own server.

The left menu of the admin is: Calls, Call history, SIP accounts, SIP phones, Groups, Routes, Call debugging, Firewall, Tools, Tool routers, Agents, Models, Rights, Languages, Users, License, Settings.