For Agents
Programmatically create contact, list contacts. Covers 6 operations with apiKey authentication.
Use for: I need to contact, I want to contacts, Search for contact, Find all contact
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Spoki API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fspoki.it%2Fspoki-it" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fspoki.it%2Fspoki-it" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Spoki API.
Create contact
List contacts
Get contact
Update contact
GET STARTED
Not supported: Does not handle payments, communications, or crm - use for marketing only.
Spoki WhatsApp marketing automation API. The API exposes 6 endpoints secured with apiKey authentication.
Send WhatsApp message
Patterns agents use Spoki API for, with concrete tasks.
★ Marketing Operations
Use the Spoki API to perform marketing operations programmatically. The API provides 6 endpoints covering core functionality including create contact, list contacts, get contact.
Call POST /contacts to create contact
Automated Contacts Management
Automate contacts operations by combining multiple Spoki API endpoints. Agents can list contacts and then get contact in a single workflow.
Call GET /contacts to list contacts, then verify the result
AI Agent Integration via Jentic
AI agents discover and call Spoki API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.
Search Jentic for 'create contact', load the operation schema, and execute with Jentic-managed credentials
6 endpoints — spoki whatsapp marketing automation api.
METHOD
PATH
DESCRIPTION
/contacts
Create contact
/contacts
List contacts
/contacts/{id}
Get contact
/contacts/{id}
Update contact
/messages/send
Send WhatsApp message
/templates
List message templates
/contacts
Create contact
/contacts
List contacts
/contacts/{id}
Get contact
/contacts/{id}
Update contact
/messages/send
Send WhatsApp message
/templates
List message templates
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Spoki API by hand means provisioning its API key, attaching it to every request, and pointing calls at the api.spoki.it/v1 host yourself. Through Jentic you install once, import the Spoki API from the API Directory, store the API key once, and your agent calls it.
Permission scoping
Spoki puts the contact id in the URL path (/contacts/{id}), so a rule can pin your agent to reading and updating one contact. You choose the operations it may call, so sending messages is not included unless you add it.
Credential isolation
Your Spoki API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'create a contact' or 'send a template message', and Jentic returns the matching Spoki API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Spoki API through Jentic.
What authentication does the Spoki API use?
The Spoki API uses an API key passed in the `Authorization` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.
Can I create contact with the Spoki API?
Yes. Use the POST /contacts endpoint. The API returns structured JSON responses that agents can parse and act on directly.
What are the rate limits for the Spoki API?
Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.
How do I create contact through Jentic?
Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'create contact'. Jentic returns the matching Spoki API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.
How many endpoints does the Spoki API have?
The Spoki API exposes 6 endpoints covering contacts, messages, templates operations.