Spoki
Spoki is an Italian platform that integrates WhatsApp's official APIs to automate communication for marketing, sales, customer support, and payments.
Verdict
Common use cases
- Upsert leads captured in chat threads
- Audit upcoming campaign schedules before launch
- Delete duplicate or outdated contact records
- Pull account metrics for weekly standup reports
- Define custom fields for new product segments
Integration
- Vendor
- Spoki
- Category
- other
- Auth
- API_KEY
- Tools
- 22
- Composio slug
spoki
Tools
- Create custom field
Tool to create a new custom field. use when defining extra data points for contacts.
- Create or Update Contact
Tool to create or update a contact. use when you need to upsert a single contact record via the sync endpoint.
- Delete contactdestructive
Tool to delete a specific contact. use after confirming the contact id. example prompt: "delete contact with id 1091234."
- Get Account Current Report
Tool to get the current report for a specified account. use when you need up-to-date metrics on messages and conversations for an account. note: result is cached for 30 minutes.
- List Agencies
Tool to list all agencies accessible to the user. use when you need to retrieve all agencies for the authenticated account.
- List Automations
Tool to list, search, and filter automations. use after authenticating to retrieve available automations and apply optional search or platform filters.
- List campaigns
Tool to list, search, and filter campaigns. use when you need to retrieve campaigns optionally filtered by scheduled datetime.
- List Contacts
Tool to list, search, and filter contacts. use when you need to retrieve contacts with optional search and filters.
- List Custom Fields
Tool to list, search, and filter custom fields. use when you need to fetch available custom-field definitions by label or code.
- List tags
Tool to list, search, and filter tags. use when you need to fetch all tags for the account.
- List Tags
Tool to list, search, and filter tags. use when you need to fetch all tags for the account.
- List templates
Tool to list, search, and filter whatsapp templates. use when you need to retrieve available templates, optionally filtering by keywords.
- List Tickets
Tool to list, search, and filter tickets. use when you need to retrieve tickets with optional pagination and filters.
- List WhatsApp templates
Tool to list, search, and filter whatsapp templates. use when you need to retrieve available templates, optionally filtering by keywords.
- Retrieve Account
Tool to retrieve details of a specific account. use after confirming the account id is valid.
- Retrieve Automation
Tool to retrieve details of a specific automation. use after listing automations to fetch full details including webhooks and timestamps. example: retrieve automation with id 345016.
- Retrieve Contact
Tool to retrieve details of a specific contact. use when you have a contact id and need full profile details.
- Retrieve Custom Field
Tool to retrieve details of a specific custom field. use when you have a field id and need its metadata before using it in automations.
- Retrieve Tag
Tool to retrieve details of a specific tag. use when you need tag metadata by id.
- Retrieve Template
Tool to retrieve details of a specific template. use after obtaining a template id.
- Spoki list partners
Deprecated placeholder for spoki list partners action file
- Update Custom Field
Tool to update a specific custom field. use after retrieving a field to change its label.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Search for Spoki and click Connect. 3. You'll be prompted to paste an API key — log into your Spoki dashboard, navigate to Settings or API Access, and generate a new key with read and write permissions for contacts, campaigns, and automations. 4. Copy the key and paste it into Switchy, then click Authorize. 5. Switchy will confirm the connection and list the 22 available tools. 6. Open any Space, type '@Spoki list contacts' and send — if the MCP returns a contact list, you're ready. 7. To test write access, try '@Spoki create or update contact' with a sample name and email; confirm the record appears in your Spoki dashboard.
What teammates see: by default, memories from Spoki are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Sync New Lead
@Spoki create or update contact with email alex@example.com, first name Alex, last name Chen, and tag them as 'demo-request'.Open in a Space →
Review Campaign Queue
@Spoki list campaigns scheduled for the next 7 days, and show me the campaign names, send times, and target audience counts.Open in a Space →
Check Account Metrics
@Spoki get the current account report and summarize total messages sent, conversations opened, and any notable changes from last month.Open in a Space →
Add Custom Field
@Spoki create a custom field called 'ProductInterest' with type text, so we can tag contacts by which feature they care about most.Open in a Space →
Clean Up Contacts
@Spoki delete contact with id 1091234 and confirm the record has been removed from the database.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Spoki list all contacts who have interacted with us in the last 30 days and show me their custom fields
Found 47 contacts with recent activity. Here's a sample: Contact #10234 (Maria Santos, +1-555-0123) has custom fields 'lead_source: webinar' and 'interest_level: high'. Contact #10891 (James Chen, +1-555-0456) shows 'lead_source: referral' and 'purchase_intent: medium'. The full list includes phone numbers, creation dates, and all custom field values you've defined. Most contacts have 3-5 custom fields populated.
This example demonstrates Spoki's contact search and custom field retrieval. The MCP requires an API key with read permissions on contacts. Response time depends on your contact database size—accounts with 10k+ contacts may see slower queries. Custom fields must already exist in your Spoki account to appear in results.
@Spoki create a new contact for John Doe with phone +1-555-9999 and set the custom field 'campaign_source' to 'spring_promo'
Contact created successfully. John Doe has been added to your Spoki account with ID #11203 and phone number +1-555-9999. The custom field 'campaign_source' is now set to 'spring_promo'. If this contact already existed, their record was updated with the new custom field value instead. The contact is now available for inclusion in campaigns and automations.
This showcases Spoki's upsert capability—it creates new contacts or updates existing ones based on phone number matching. You must create the custom field 'campaign_source' separately before setting its value (use the create custom field tool first). This action immediately makes the contact targetable in your messaging workflows.
@Spoki pull the current account report and summarize which message types are performing best this month
Your account sent 3,847 messages this month. WhatsApp messages show the highest engagement: 2,103 sent with an 89% delivery rate and 67% read rate. SMS messages (1,744 sent) have a 95% delivery rate but only 23% engagement tracking available. Conversations initiated: 412, with an average response time of 4.2 hours. Note: this data is cached for 30 minutes, so very recent activity may not appear until the next refresh.
This example pairs Spoki's reporting tool with AI analysis to surface actionable insights from raw metrics. The 30-minute cache means you won't see real-time data—useful for periodic check-ins, not live monitoring. Requires API access to account-level reports. The AI can compare trends if you request reports across multiple time periods.
Use-case deep-dives
When Spoki wins for WhatsApp-first support teams
A 6-person support team at a regional e-commerce brand uses WhatsApp as their primary customer channel and needs contact records in sync with their CRM. Spoki's "Create or Update Contact" tool handles the upsert pattern cleanly—when a customer messages in, the team can pull their order history from Shopify and push updated contact fields back to Spoki without duplicate-checking logic. The 22-tool surface means you're also set for campaign sends and automation triggers from the same workspace. This works until you hit multi-channel complexity: if your team juggles email, SMS, and WhatsApp in parallel, Spoki's scope stays narrow and you'll need a second MCP for the other channels. If 80% of your inbound is WhatsApp and you want one API key to rule contact sync and broadcast sends, Spoki is the call.
When Spoki fits monthly campaign retrospectives
A 3-person marketing team at a SaaS startup runs monthly WhatsApp campaigns to trial users and needs to pull send metrics into their board deck. Spoki's "Get Account Current Report" tool surfaces message counts and conversation stats in one call, and the 30-minute cache means you can refresh the numbers during your retro without hammering the API. The "List campaigns" filter by scheduled date lets you isolate last month's sends and compare performance across cohorts. This breaks down if you need real-time alerting or sub-hour granularity—the cache window is too wide for intraday pivots. It also assumes WhatsApp is your only broadcast channel; if you're orchestrating email and push in the same campaign, you'll need separate tooling. For end-of-sprint or end-of-month campaign reviews where WhatsApp is the hero channel, Spoki delivers the metrics without ceremony.
When Spoki scales multi-client automation setup
A 10-person agency manages WhatsApp automations for 40 retail clients and needs to clone automation templates across accounts during onboarding. Spoki's "List Agencies" and "List Automations" tools let you enumerate all accessible accounts and their automation configs in two calls, then script the template copy with "Create custom field" to match each client's data model. The API key auth means you can delegate per-client access without OAuth ceremony, and the 22-tool breadth covers contact import, campaign scheduling, and custom field setup in one integration. This works until client count crosses 100—at that scale, the lack of bulk endpoints and the 30-minute report cache start to feel slow. If you're onboarding 2-5 clients a month and each needs a bespoke automation stack on WhatsApp, Spoki keeps the setup scriptable without a second MCP.
Frequently asked
What does the Spoki MCP let me do in Switchy?
The Spoki MCP connects your WhatsApp Business messaging platform to Switchy's AI workspace. It lets you create and update contacts, manage custom fields, list campaigns and automations, delete contacts, and pull account reports — all without leaving your chat. Think of it as a conversational interface for your Spoki contact database and messaging workflows.
Do I need admin access to connect Spoki?
You need an API key from your Spoki account, which typically requires admin or developer permissions to generate. Once you have the key, paste it into Switchy's connection flow. If you're not an admin, ask whoever manages your Spoki workspace to create a key and share it with you securely.
Can the Spoki MCP send WhatsApp messages or start campaigns?
No. The MCP focuses on contact management and reporting — creating contacts, updating custom fields, listing campaigns and automations, pulling account metrics. It doesn't send messages or trigger campaigns directly. For that, you still use Spoki's web interface or their dedicated sending APIs.
How is this different from logging into Spoki's dashboard?
Switchy's MCP lets you query and update Spoki data in natural language alongside other tools in your workspace. Instead of switching tabs to search contacts or check campaign lists, you ask the AI and it calls the Spoki API for you. The dashboard is still better for visual campaign builders and bulk operations.
Who on my team should connect the Spoki MCP?
Whoever manages your WhatsApp contact lists and campaigns — typically your marketing ops or customer success lead. They'll need access to Spoki's API key. Once connected, any Switchy workspace member can ask questions about contacts or campaigns, but only the connector's API key determines what data is visible.