Skip to content
Supporto Spoki

Documentation for Spoki use

  • English
    • Italiano
    • Español
  • English
    • Italiano
    • Español

Integrations

37
  • Integrate WhatsApp with Google Sheets
  • Integrating Spoki with Facebook forms.
  • Integrating Spoki with Brevo (formerly sendinblue)
  • Integrating WhatsApp with Zapier
  • Integrating WhatsApp with Hubspot
  • Integrating WhatsApp with Qapla’
  • Integrating WhatsApp with ActiveCampaign
  • Klaviyo and Spoki Integration.
  • Integrating WhatsApp with IFTTT
  • Integrate WhatsApp with Zoho
  • Integrate WhatsApp to WPNotif
  • Integrate WhatsApp with Semplisio
  • Integrating Spoki with Webhooks
  • Integrate Spoki with any management system via API
  • Integrating Calendly with Spoki
  • How to send a Webhook out of Spoki vs. a management system
  • Integrating WhatsApp with Paypal
  • Zadarma
  • Setting Up Your Spoki Voice Agent
  • Microsoft Dynamics 365 Integration
  • Spoki WhatsApp Chat Chrome Extension
  • Integrate Prestashop to WhatsApp
  • WhatsApp and WooCommerce Integration
  • Integrate WhatsApp with Google Calendar
  • Embed Spoki on your Software
  • Spoki Integration with Connectif: Automating WhatsApp Messages
  • Integrate WhatsApp with Shopify
  • Insert Chat Button on Shopify
  • Get Started with Spoki MCP
  • Sync Klaviyo Lists and Segments with Spoki
  • Gorgias
  • Make
  • Shopify App
  • Ringover
  • Magnews Flow
  • Salesforce Flow

Platform

16
  • Lists
  • Dynamic fields
  • Import CSV from Lists
  • Apply for OBA (Official Business Account) WhatsApp
  • Ticket
  • How to verify the authenticity of Spoki emails
  • Deals – User Guide
  • Contact
  • Dashboard
  • Chat
  • Campaigns
  • Template messages
  • Chat buttons
  • Tags
  • Integrations
  • Automations

How to

83
  • “Transform Contact Field” step: when and how to use it
  • Practical guide: how to write a prompt that works
  • How to create a simple automation from the Campaigns section
  • Spoki on your Smartphone – Web App and Notifications
  • “Delay” Step: When and How to Use It
  • Quick Action “If/Else”
  • How to Filter Chats by One or More Tags/Agents/Lists/Tickets
  • Marketing Consent on Spoki: Operational Guide
  • Guide to the Branching Option in Automations
  • Introduction to Using the OTP Code
  • Guida allo step “Attendi risposta”
  • How to Upload a Contact List on Spoki: A Step-by-Step Guide
  • Crafting AI Prompts
  • How to send the content of a message to an external webhook
  • How to set up a CTA with dynamic field
  • Multiple steps in automation
  • HOW TO TRACK CLICKS ON TEMPLATE MESSAGE LINKS: UTM
  • How to write documents for AI
  • Template suggested by Artificial Intelligence (AI)
  • How to create a marketing funnel on Shopify
  • Integrating Spoki with Meta Listings
  • How to build your own AI Agent
  • Restore all blocked contacts
  • Translate messages and replies if the contact has a different language
  • Transcription and translation of audio in chat
  • Permanently delete a contact on Spoki
  • How to export all messages from a chat as CSV
  • How to change media in the Template before sending it in chat
  • How to create a list for contacts in a specific automation step
  • New features of Active Campaign
  • How to populate a dynamic field
  • How to activate catalog display on WhatsApp
  • How to add Tag in automation before inserting it
  • How to generate a list from Campaign Statistics
  • How to segment clients within Automations.
  • How not to let your recharge expire
  • How to automatically manage who replies/does not reply to a message
  • How to terminate automation manually for specific contacts
  • HOW TO CREATE A LIST FOR CONTACTS IN A SPECIFIC AUTOMATION STEP
  • How to change media in Template before sending it to chat
  • How to export all chat messages as CSV
  • Audio transcription and translation in chat
  • Delete contact permanently on Spoki
  • Train artificial intelligence (AI) on Spoki
  • How to set up a CTA with dynamic field
  • How to automatically manage who replies/doesn’t reply to a message
  • Free messages with buttons
  • How to get a single contact out of all automations
  • Spoki – first steps
  • How to transfer contacts from your Whatsapp app to Spoki
  • How to handle cases when I have to send a chat reply to a customer after 24 hours?
  • How to withdraw from Spoki service
  • HOW TO LINK SPOKI TO FACEBOOK INTERACTION CAMPAIGNS
  • How to manage booking Calendly + Active Campaign + Spoki
  • How to consult automation reporting
  • How to send multi-language messages
  • How can I identify which user has replied in chat to a message?
  • How to populate a dynamic field via CSV upload and submit a campaign
  • How to enable automation for birthday greeting message
  • How to automatically handle those who do not respond
  • How to activate the Woocommerce plugin associated with Spoki Pro
  • How to enable automation for non-working hours
  • How to link Spoki to Facebook campaigns
  • How to activate an automatic message to run on holidays
  • How to link a Chat Button on the website to an automated response
  • How to insert WhatsApp chat button on WordPress site
  • How to update Spoki’s WhatsApp profile
  • Recommended proportions for images in Whatsapp messages
  • How to create template button response automation
  • How to start an automation with API
  • How to enable notifications on Spoki
  • How to lock/unlock contacts automatically
  • How to create new users and assign different roles
  • How to integrate Spoki for your customers into your software
  • How to recover abandoned shopping carts on Woocommerce
  • How to Automatically Send a Reminder Message Using Spoki
  • How to duplicate automations/ templates
  • Managing Free Messages in the Automation Flow
  • How to attribute or remove tags to contacts in a list
  • How to delete multiple contacts
  • Migration from old Twilio provider
  • View only unread chats
  • How to Use the Return Webhook from Spoki to Zapier

Strategies

11
  • WhatsApp Strategies for Christmas: The Complete Guide to Maximizing Sales and Customer Satisfaction
  • WhatsApp That Sells – Mini Strategic Guide by Sector
  • WhatsApp for E-commerce: How to Turn Conversations into Sales with Spoki
  • Why Spoki AI is Essential in Every Communication and Sales Strategy
  • Reach All Your Contacts Without Exceptions: SMS Integrated into Spoki Automations
  • Practical Guide to Creating, Optimizing, and Approving WhatsApp Templates with Spoki and ChatGPT
  • The 6 Most Effective Automations to Use with Spoki
  • Tips for mass mailings over 10,000 contacts

WhatsApp rules

8
  • “Daily” contact limits
  • Quality of messages sent
  • Types of messages
  • What to do if your account is in low quality
  • What to do if you have been banned from WhatsApp
  • Authorization for use
  • Conversations: Costs and Usage
  • Rules to avoid ban from WhatsApp

Onboarding

9
  • Activation of Spoki with a free Meta number
  • Guide to migrating your number
  • Guide to migrating your number with WhatsApp Business (coexistence)
  • 2a. Accepting notification from Tyntec
  • Attivazione Spoki – Autorizzazione da Meta BM (numero WhatsApp Business)
  • 2. Verify Meta Business Manager
  • Before activating Spoki: What you need to know about your existing WhatsApp number
  • Plans and prices | Spoki
  • 3. Spoki Training Course

Release Notes

4
  • Carousel Template
  • Report Tickets
  • Commerce Triggers
  • Automation step “Start automation”
  • Home
  • Docs
  • Integrations
  • Setting Up Your Spoki Voice Agent
View Categories

Setting Up Your Spoki Voice Agent

This manual explains how to configure AI-driven voice calls, test them for quality, and integrate them into automated customer journeys.

1. Creating Your First Voice Agent #

The Voice Agent is the “brain” of your phone call. It uses AI technology to converse naturally with customers.

Step-by-Step Configuration: #

  1. Access the AI Panel: Open your Spoki Dashboard and click on Intelligenza Artificiale (AI) in the left sidebar.
  2. Start New Agent: Click the Voice Agent tab and then the green + New button. Choose Custom Agent.
  3. Core Settings:
    • Name: Internally identify the agent (e.g., “Appointment Confirmation Bot”).
    • First Message: This is the very first thing the AI says. Legal requirement: under Article 50 of the EU AI Act (applicable from 2 August 2026), the person receiving the call must be clearly informed, at the very start of the conversation, that they are talking to an AI system. Always include this disclosure in your First Message.
    • Example: “Hi! This is Spoki’s virtual assistant — an AI agent calling on behalf of [Company Name] to confirm your demo for tomorrow. Is now a good time?”
    • ⚠️ Do not configure the agent to deny being an AI or to impersonate a human, even if asked. This violates the EU AI Act and your Spoki contract.
    • System Prompt: This is the most important part. Define the “Rules of Engagement.”
      • Who is the AI? (e.g., “You are a helpful sales assistant”).
      • What is the goal? (e.g., “Confirm the date and time of the meeting”).
      • Tone: (e.g., “Be professional but friendly”).
      • Compliance: instruct the agent to confirm it is an AI if asked, never to collect more personal data than necessary for the goal of the call, and to end the call politely if the person asks not to be contacted again (and record the opt-out).
    • Success Criteria: Define what a “Win” looks like. The AI will analyze the call to see if this was met.

AI page

First Message

Success Criteria

2. Refining Voice & Tone #

A natural voice is key to customer retention.

  • Voice Selection: Choose from various profiles (e.g., Katie, Ronald, Francesca). Match the voice to your brand persona.
  • Temperature: * Lower (0.1 – 0.3): More focused and repetitive. Good for strictly regulated industries.
    • Higher (0.7 – 1.0): More creative and human-like. Good for sales and general support.
  • Voice Speed: We recommend a setting between 0.9x and 1.1x. Anything faster feels “robotic,” and slower feels sluggish.

Voice Config

3. Testing in the “Playground” #

Never launch an automation without testing the logic first.

  1. Click the Playground button in the top right.
  2. Select your Agent and click Start Call.
  3. Live Interaction: Speak to the agent as if you were a customer. Try to “trick” it or ask off-topic questions to see how it recovers.
  4. Analyze Results: Go to the Calls menu on the sidebar. Here you can:
    • Listen to the audio recording.
    • Read the Full Transcription.
    • See the Summary generated by the AI.

Note on recordings: call recordings, transcriptions and AI summaries contain personal data. Access them on a need-to-know basis, define a retention period consistent with your privacy notice, and delete test calls containing real personal data when no longer needed.

Playground

Click on Agent to Start the live call

Check the details

Call Overview

Call Transcription

4. Legal requirements #

Legal requirements before launching AI voice calls

AI voice calls are subject to specific EU and Italian rules. As the data controller and deployer of the Voice Agent, you are responsible for the following (see your Spoki Contract and the Data Processing Agreement):

1. Tell people they are talking to an AI (EU AI Act, Art. 50). From 2 August 2026, every AI voice call must disclose, at the first interaction, that the caller is an AI system. Spoki’s platform supports this via the First Message — never remove the disclosure. Penalties can reach €15M or 3% of worldwide annual turnover.

2. Call only contacts with valid consent (Art. 130 of the Italian Privacy Code). Automated calls without a human operator require the contact’s prior, specific, documented opt-in consent for automated communications. Registration in the Italian Public Opt-out Register (Registro Pubblico delle Opposizioni) overrides previous consents — check your lists before each campaign. Additional sector restrictions may apply (e.g., since 19 June 2026 unsolicited telephone marketing of electricity and gas contracts is prohibited).

3. Inform about recording and transcription (GDPR, Arts. 13–14). Calls made through Spoki Voice are recorded, transcribed and summarized by AI. Your privacy notice must cover this processing, and the agent should mention the recording at the start of the call with a link/reference to the full notice. Keep recordings only as long as necessary and limit access to authorized staff.

4. Use a genuine, callable phone number (AGCOM Resolution 106/25/CONS). Calls must present a real caller ID that the recipient can call back. Spoofed or unidentifiable numbers are blocked by Italian operators.

5. Assess the risk before large-scale use. If you use the Voice Agent systematically or on large contact lists, carry out a Data Protection Impact Assessment (DPIA) with your DPO or privacy advisor.

Spoki (NextAI S.r.l.) acts as your data processor for these calls and relies on selected AI Service Providers under the conditions set out in your Contract and DPA. Misuse of the Voice Agent in breach of these rules may lead to suspension of the Service under the Contract.

This section is provided for information purposes and does not replace legal advice.

5. Automating the Call Workflow #

Once the agent is ready, you can make it part of a larger workflow (e.g., calling a lead 5 minutes after they fill out a form).

⚠️ Consent check: make sure your form collects a specific, freely-given opt-in for automated voice calls (separate from the general marketing consent) before triggering the Voice action. Keep proof of consent.

  1. Go to Automations and click + New.
  2. Add an Action and select Spoki Voice.
  3. Smart Branching: Once you add the voice action, Spoki creates branches based on what happened during the call:
    • Success: The goal was met (e.g., Appointment confirmed).
    • Neutral: The conversation happened but no specific outcome was reached.
    • Call Me Back: The customer asked to be contacted later.
    • No Answer/Rejected: Use this branch to send a follow-up WhatsApp message automatically.

Step Voice in Automations

Step Voice

6. Compliance & Privacy (GDPR) #

Because a Voice Agent records, transcribes and processes the voice of the people it calls, you — as the account owner — are the data controller and are responsible for using it lawfully. Most of the day-to-day compliance is built directly into your prompt.

In the First Message, always disclose, before anything else, (1) that the caller is an AI, (2) who is calling and why, and (3) that the call is recorded. Example:

“Ciao, sono un assistente virtuale di [Azienda]. Ti chiamo per [motivo]. Questa chiamata è registrata e trascritta per finalità di [gestione appuntamenti / assistenza]. Va bene se continuiamo?”

In the System Prompt, add explicit rules so the agent stays compliant, for example:

If the customer objects to being recorded, acknowledge it politely, do not insist, and end the call. 

Do not ask for or record special-category data (health, religion, political views, etc.). If the customer volunteers it, do not repeat it back.

Collect only the data strictly needed for the stated goal 

What are your Feelings

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Still stuck? How can we help?

How can we help?

Updated on July 14, 2026
Get Started with Spoki MCPMicrosoft Dynamics 365 Integration

Powered by BetterDocs

Table of Contents
  • 1. Creating Your First Voice Agent
    • Step-by-Step Configuration:
  • 2. Refining Voice & Tone
  • 3. Testing in the "Playground"
  • 4. Legal requirements
  • 5. Automating the Call Workflow
  • 6. Compliance & Privacy (GDPR)
DEVELOP YOUR BUSINESS WITH SPOKI AND WHATSAPP
Try now for free

Contacts

  • info@spoki.it
  • +39 351 5495135
  • Informativa Privacy

Menu

  • Home
  • Prices
  • Functionality
  • Integrations
  • Artificial Intelligence
  • About us

Solutions

  • Marketing
  • Sales
  • Customer Care
  • Developers

Support

  • API Documentation
  • Blog
  • Case Study
  • Learning Center
  • Manual

Spoki.it © All rights reserved NextAI Srl P.IVA IT02717930743 Viale Francia snc, 72019 San Vito Dei Normanni (BR) Italy

Soluzioni

  • Marketing
  • Vendita
  • Assistenza Clienti
  • Developers
  • Italiano (Italian)
  • English
  • Español (Spanish)