ceven

Spoki

Automates WhatsApp communication flows, manages contact data, and triggers marketing campaigns based on real time customer events.

Try Spoki in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Spoki integration

    • Describe the outcome and Ceven picks the right Spoki calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Spoki data, across all 57 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Spoki access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Spoki, when, and on whose behalf.
    • The agent pauses and asks when Spoki is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Spoki.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Spoki action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Spoki, and when to use it.

Create or Update Contact
Use this to upsert a single contact record. Pulls or pushes customer data to keep the Spoki directory current.
Delete contact
Remove a specific contact by ID. Use this when a user requests data deletion for privacy compliance.
Get Account Current Report
Pull current metrics on messages and conversations for a specific account to monitor delivery rates.
List Automations
Retrieve all active automations. Use this to audit which WhatsApp flows are currently live.
List campaigns
Pull a list of marketing campaigns, optionally filtered by the scheduled date and time.
List Contacts
Search and filter the contact database to find specific users or segments for a broadcast.
List tags
Fetch all available tags to ensure the agent uses the correct label for a customer segment.
List templates
Retrieve available WhatsApp templates. Use this to find the right message structure by keyword.
List Tickets
Pull a list of open support tickets to prioritize customer replies in the workflow.
Retrieve Contact
Pull full profile details for a specific contact ID to personalize a message.
Create custom field
Define a new data point for contacts. Use this when adding a new attribute like loyalty tier.
List Custom Fields
Fetch all custom field definitions by label or code to map data correctly.
Retrieve Custom Field
Pull metadata for a specific field ID before using it in a complex automation.
Update Custom Field
Change the label or settings of an existing custom field to keep data organized.
Retrieve Automation
Pull full details for a specific automation including webhooks and timestamps.
Retrieve Template
Fetch the exact content and variables of a WhatsApp template by its ID.
List Agencies
Tool to list all agencies accessible to the user. use when you need to retrieve all agencies for the authenticated account.
Retrieve Account
Tool to retrieve details of a specific account. use after confirming the account id is valid.
Retrieve Tag
Tool to retrieve details of a specific tag. use when you need tag metadata by id.
Spoki list partners
Deprecated placeholder for spoki list partners action file
List WhatsApp templates
Tool to list, search, and filter whatsapp templates. use when you need to retrieve available templates, optionally filtering by keywords.

21 actions · scroll to see them all

Frequently asked questions

Ceven does not submit templates to Meta for approval directly. You must create and submit your templates within the Spoki dashboard first. Once Meta approves the template, Ceven can see it using the List templates action. The agent then uses the approved template ID to send messages to your customers. If you try to send a message using a template that is still pending or was rejected, Spoki will return an error and the Ceven workflow will mark the step as failed. We recommend creating your templates in Spoki a few days before you plan to launch a new automated workflow.
No, this is a limitation of the WhatsApp Business API that Spoki uses. You cannot send a free form message to a user unless they have messaged you first within the last 24 hours. Outside of that window, the agent must use an approved WhatsApp template. If the agent attempts to send a non template message to a cold contact, the API call will fail. Ceven handles this by checking the last interaction timestamp and automatically switching to a template if the 24 hour window has closed, ensuring your account remains compliant with Meta policies.
Ceven treats custom fields as dynamic metadata. The agent first uses the List Custom Fields action to find the internal code for the field you want to update. Once the code is identified, the agent can push specific values into that field for any contact. This is useful for storing order IDs, appointment dates, or lead scores. Because custom fields are defined at the account level in Spoki, any changes made by the agent to a field label will reflect across all contacts using that field. We suggest creating your fields in Spoki first to avoid duplicate definitions.
When a customer replies, Spoki generates a ticket. Ceven can be configured to poll the List Tickets action or react to a webhook to detect these replies. The agent then retrieves the ticket content and the associated contact profile. It can then perform a lookup in your external database to find the answer to the customer question and draft a response. This response can be sent automatically if you trust the model, or it can be pushed to a slack channel for a human to review and click send within the Spoki interface.
Yes, Spoki enforces rate limits based on your specific subscription tier and the WhatsApp Business API limits. If your workflow attempts to sync thousands of contacts in a few seconds, you may encounter a 429 Too Many Requests error. Ceven manages this by implementing an exponential backoff strategy. If the agent hits a limit, it will pause the execution and retry the request after a short delay. For very large bulk updates, we recommend scheduling the workflow to run in smaller batches over several hours to avoid triggering Meta spam filters.
Yes, if your account has access to multiple agencies, the agent can use the List Agencies action to identify the correct agency context. When performing actions like listing contacts or sending messages, the agent specifies the agency ID to ensure the data is pulled from the right bucket. This is particularly useful for marketing agencies that manage WhatsApp communication for multiple clients through a single Spoki master account. You can build a single workflow that iterates through a list of agencies and performs the same reporting or cleanup tasks for each one.
The agent uses the Create or Update Contact action as an upsert mechanism. This means the agent sends the contact data along with a unique identifier, usually a phone number or email. If the contact already exists in Spoki, the platform updates the existing record with the new information. If the contact does not exist, Spoki creates a new profile. This prevents the creation of duplicate records and ensures that your customer history remains unified. The agent can also add tags during this process to instantly categorize the user for future campaigns.
Ceven processes message content in real time to execute your workflows, but we do not maintain a permanent archive of your WhatsApp conversations. The messages are stored within Spoki and on Meta servers. When the agent pulls a ticket or a contact record, it is doing so via a secure API call to Spoki. Once the workflow step is complete and the logic is processed, the transient data is cleared from the agent memory. This ensures that your customer communications remain private and are managed solely within your authorized Spoki environment.

Alternatives to Spoki

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

MessageBird logoMessageBirdTwilio logoTwilioWati logoWati

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Spoki and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free