# Spoki AI integration on Definable

> Spoki is an Italian platform that integrates WhatsApp's official APIs to automate communication for marketing, sales, customer support, and payments.

## What this connects

Spoki is an Italian platform that integrates WhatsApp's official APIs to automate communication for marketing, sales, customer support, and payments.

Vendor: https://spoki.it/en/

## Tools available

**57** tools available. First 12:

- `SPOKI_ADD_CONTACT_OPERATOR` — Add Contact Operator — Tool to assign an operator to a contact's chat. Use this when you need to assign a team member to handle a specific contact's conversation. The operator must have been invited to the account first. Rate limited to 5 requests per minute.
- `SPOKI_ADD_SERVICE_USER` — Add Service User — Adds a new service user with a specific role to your Spoki account. Use this when you need to create service accounts for automation, API integrations, or specialized operator roles. Rate limit: 10 requests per minute.
- `SPOKI_CHECK_ROLE_PRIVATE_KEY` — Check Role Private Key — Tool to check if a service user role has a private key configured. Use when you need to verify key status for a role. Rate limit: 10 requests per minute.
- `SPOKI_CLONE_TEMPLATE` — Clone Template — Tool to create a duplicate copy of an existing template. Clone starts in DRAFT status. Use when you need to duplicate a template by ID.
- `SPOKI_CREATE_ACCOUNT_ONBOARDING_LINK` — Create Account Onboarding Link — Tool to create an onboarding link for a specific Spoki account. Use when you need to generate a setup link to help users configure their account.
- `SPOKI_CREATE_CUSTOM_FIELD` — Create Custom Field — Creates a new custom field in Spoki for storing additional contact data. Use this action when you need to define extra data points that can be stored on contacts beyond the standard fields. Custom fields are useful for tracking business-specific information like customer IDs, preferences, subscription dates, or any other structured data. The custom field will be available for use immediately after creation across contact management, automation workflows, and API operations. Ensure the label and code are unique and descriptive for easy identification and usage.
- `SPOKI_CREATE_LIST` — Create Contact List — Creates a new contact list in Spoki for organizing and managing contacts. Use this action when you need to create a new list for grouping contacts by campaigns, segments, or any other organizational criteria. Lists are essential for targeted messaging, automation workflows, and campaign management. Rate limit: 10 requests per minute.
- `SPOKI_CREATE_MEDIA` — Create Media File — Tool to create a new media file entry in Spoki. Use when you need to register external media files (images, videos, documents) that can be used in campaigns, messages, or other Spoki features. Rate limit: 120 requests per minute.
- `SPOKI_CREATE_OR_UPDATE_CONTACT` — Create or Update Contact — Creates a new contact or updates an existing contact in Spoki using the phone number as the unique identifier. This action performs an "upsert" operation: - If a contact with the provided phone number exists, it will be updated with the new information - If no contact exists with that phone number, a new contact will be created Use this when you need to: - Add new contacts to your Spoki account - Update existing contact information (name, email, language, custom fields) - Ensure contact records are synchronized with external systems The phone number must be in E.164 format (international format with country code).
- `SPOKI_CREATE_TEMPLATE` — Create Template — Creates a new WhatsApp message template with localizations, buttons, and media headers. Use when you need to define a reusable template for marketing campaigns, transactional notifications, or authentication messages. Templates must be approved by WhatsApp before use (created in DRAFT status). Rate limit: 10 requests per minute.
- `SPOKI_CREATE_TICKET` — Create Ticket — Tool to create a new support ticket in Spoki. Use when you need to create a ticket for tracking customer support issues or requests. Rate limit: 120 requests per minute.
- `SPOKI_DELETE_CONTACT` — Delete contact — Tool to delete a specific contact. Use after confirming the contact ID. Example prompt: "Delete contact with ID 1091234."

## Auth

Auth schemes: `API_KEY`.

## How agents use Spoki

Inside a Definable workflow, Spoki is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Spoki** — the Researcher (GPT-5.5) pulls context from Spoki (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Spoki** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Spoki (create record, post message, draft email).
- **Designer / Engineer → Distributor → Spoki** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Spoki (attach file, open PR comment, post status).

The Verifier checks every Spoki call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- marketing automation — https://definable.ai/apps/category/marketing-automation/
- phone & sms — https://definable.ai/apps/category/phone-&-sms/

## Related

- HTML page: https://definable.ai/apps/spoki/
- Same category (marketing automation): https://definable.ai/apps/category/marketing-automation/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt