Become a partner

A partner is software — a CRM, a booking system, a management suite — whose customers connect their Talki account to it through an OAuth app. For each customer you choose who pays for the Talki subscription: the customer, or you.

Two ways to bill

	The customer pays Talki	You pay for the customer
Subscription	The customer’s own, bought on app.talki.it or in the Talki app	Yours; the customer sees «managed by» your app and no prices or payments
Before connecting	The customer needs a Talki account and a subscription	Nothing: the customer creates the account inside the activation flow
Plan	The customer’s choice	Yours: base, pro or business, set per customer and changeable through the API
/v1 and app events	Only while the customer is on Business	On every plan, for your app only
Price to the customer	Talki’s list price	Yours; Talki invoices you under the terms agreed with you
Setup	Register an app	Register an app, then have it enabled for managed billing

Both use the same app, consent screen and tokens. An app enabled for managed billing can still connect customers who pay for themselves: an authorization URL without an enrollment is an ordinary connect.

Customers who pay Talki

Register an app in the console and follow OAuth apps. The customer’s plan decides what your app can reach: the REST API needs Business, and on a lower plan every call answers plan_upgrade_required (see Plans). When the customer’s subscription lapses or drops below Business, your app receives installation.access_suspended.

Customers you pay for

The customer presses a button in your software — «Attiva Talki», for example — and your server asks Talki for a single-use activation. The customer creates a Talki account (or signs in) and approves your app; from that moment the account is on your bill, on the plan you chose, and it appears on your app’s Businesses page in the console.

What you control:

• The plan of each account, through /oauth/managed-accounts. An upgrade applies at once, a downgrade on the 1st of the next month.
• When management ends. The customer keeps access, on your bill, until the end of the current month, then becomes an ordinary Talki customer.
• The monthly usage of every account you pay for, to the second, on the app’s Usage page in the console, as a CSV export, and from your server through GET /oauth/app/usage.

A plan with no minute cap, unlimited, is available to apps whose terms include it. Its other limits are those of Business.

The full flow, the endpoints and their errors are in Managed billing.

Apply

1. Register your app in the console and submit it for review. The sandbox that comes with it lets you build before you have a customer.
2. Write to info@talki.it with:
   • your company and the product your customers use;
   • the app’s client ID (talki_cid_…);
   • whether you will pay for your customers, they will pay Talki, or both;
   • roughly how many customers you expect to activate, and how quickly;
   • the scopes you need.
3. For managed billing, the commercial terms are agreed first; the app is then enabled and a default plan is set. Managed billing cannot be switched on from the console.