Getting Started

Welcome! Zilkr is based on a simple idea…phone numbers are way more powerful when they come with APIs.

Think of Zilkr like Twilio, but instead of buying numbers first and then using APIs, you use APIs first and let us do the work of finding numbers that want your app. Zilkr works directly with phone companies so their customers see, choose and use the apps and integrations you build here.

The API

Zilkr’s API is super simple. Its is a collection of HTTPS-only, REST-based methods that take structured JSON content. Its also a collection HTTPS-only webhooks, to notify your service when activity occurs.

Keep three things in mind when using the API…

  1. We tell you whenever a number gets attached to your app. This can happen when a business sees your app and gives it to a bunch of users, when a user sees your app and chooses it, when a phone company sees your app and gives it to a lot of businesses at once. This is Provisioning. You always care about this.
  2. We tell you whenever phone call activity happens. This only happens if you tell us you care about phone calls. And it happens only after your app gets attached to numbers. This is Calls. If you are not thinking of phone call integration in your app, you can safely ignore these Calls commands and the Calls webhook.
  3. We tell you whenever texts/chat activity happens. This only happens if you tell us you care about texts/SMSs. And it happens only after your app gets attached to numbers. This is Messages. If you are not thinking of text/SMS integration in your app, you can safely ignore these Messages commands and the Messages webhook.

Using the API

Access to Zilkr’s API is free, requires an account and takes API tokens in each API command. If you haven’t already signed up, do that first. Create as many ’Apps’ inside your account, use the token for each App when you’re making API calls to Zilkr, and when you’re done testing, hit Publish. Publishing your app instantly makes it viewable to every phone company Zilkr works with.

As these companies attach your app to their customers, you get Provisioning events. Now, as those customers use their phone companies’ numbers, you get Calls and Messages events. The moment you get a Provisioning event, you know there is a user and phone number attached to your app, your commands will work and events may start flowing your way.