Skip to content
Supporto Spoki

Documentation for Spoki use

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

How to

81
  • “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
  • 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 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

Integrations

38
  • 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
  • Connect Shopify to Spoki AI Sales Agent
  • Zadarma
  • Configurazione del tuo 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

Onboarding

10
  • Guide to migrating your free Meta number
  • Guide to migrating your number with WhatsApp Business (coexistence)
  • Activation of Spoki with a free Meta number
  • Guide to migrating your number
  • 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

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 you have been banned from WhatsApp
  • What to do if your account is in low quality
  • Authorization for use
  • Conversations: Costs and Usage
  • Rules to avoid ban from WhatsApp

Release Notes

4
  • Carousel Template
  • Report Tickets
  • Commerce Triggers
  • Automation step “Start automation”
  • Home
  • Docs
  • Integrations
  • Configurazione del tuo Spoki Voice Agent
View Categories

Configurazione del tuo Spoki Voice Agent

Questo manuale spiega come configurare le chiamate vocali basate sull’IA, testarne la qualità e integrarle nei percorsi cliente automatizzati.

1. Creazione del tuo primo Voice Agent

Il Voice Agent è il “cervello” della tua chiamata telefonica. Utilizza la tecnologia IA per conversare in modo naturale con i clienti.

Configurazione passo dopo passo:

  1. Accedi al pannello AI: Apri la tua Dashboard Spoki e clicca su Intelligenza Artificiale (AI) nella barra laterale sinistra.
  2. Avvia un nuovo agente: Clicca sulla scheda Voice Agent e poi sul pulsante verde + Nuovo. Scegli Custom Agent.
  3. Impostazioni principali:
    • Nome: Identifica l’agente internamente (es. “Bot di conferma appuntamenti”).
    • Primo messaggio: Questa è la primissima cosa che l’IA dice. Obbligo legale: ai sensi dell’Articolo 50 dell’AI Act dell’UE (applicabile dal 2 agosto 2026), la persona che riceve la chiamata deve essere chiaramente informata, fin dall’inizio della conversazione, che sta parlando con un sistema di intelligenza artificiale. Includi sempre questa dichiarazione nel Primo Messaggio.
    • Esempio: “Salve! Sono l’assistente virtuale di Spoki — un agente IA che chiama per conto di [Nome Azienda] per confermare la sua demo di domani. È un buon momento per parlare?”
    • ⚠️ Non configurare l’agente in modo che neghi di essere un’IA o che si finga umano, anche se richiesto. Ciò viola l’AI Act dell’UE e il tuo contratto con Spoki.
    • System Prompt: Questa è la parte più importante. Definisce le “Regole di Ingaggio.”
      • Chi è l’IA? (es. “Sei un assistente commerciale disponibile”).
      • Qual è l’obiettivo? (es. “Confermare data e ora dell’appuntamento”).
      • Tono: (es. “Professionale ma cordiale”).
      • Conformità: istruisci l’agente a confermare di essere un’IA se richiesto, a non raccogliere mai più dati personali del necessario per l’obiettivo della chiamata, e a terminare la chiamata cortesemente se la persona chiede di non essere più contattata (registrando l’opt-out).
    • Criteri di successo: Definisci come appare una “vittoria” (Win). L’IA analizzerà la chiamata per verificare se questo obiettivo è stato raggiunto.

AI page

First Message

Success Criteria

2. Perfezionamento di voce e tono

Una voce naturale è fondamentale per la fidelizzazione dei clienti.

  • Selezione della voce: Scegli tra vari profili (es. Katie, Ronald, Francesca). Abbina la voce all’identità del tuo brand.
  • Temperatura:
    • Bassa (0.1 – 0.3): Più focalizzata e ripetitiva. Adatta a settori fortemente regolamentati.
    • Alta (0.7 – 1.0): Più creativa e simile all’umano. Adatta a vendite e supporto generale.
  • Velocità della voce: Consigliamo un’impostazione tra 0.9x e 1.1x. Valori superiori risultano “robotici”, mentre valori inferiori risultano lenti/poco reattivi.

Voice Config

3. Test nel “Playground” #

Non avviare mai un’automazione senza prima testarne la logica.

  1. Clicca sul pulsante Playground in alto a destra.
  2. Seleziona il tuo Agente e clicca su Start Call.
  3. Interazione dal vivo: Parla con l’agente come se fossi un cliente. Prova a “metterlo in difficoltà” o a fare domande fuori tema per vedere come reagisce.
  4. Analizza i risultati: Vai al menu Calls nella barra laterale. Qui puoi:
    • Ascoltare la registrazione audio.
    • Leggere la Trascrizione completa.
    • Vedere il Riepilogo generato dall’IA.

Nota sulle registrazioni: le registrazioni delle chiamate, le trascrizioni e i riepiloghi generati dall’IA contengono dati personali. Accedivi solo in base alla necessità di conoscerli (need-to-know), definisci un periodo di conservazione coerente con la tua informativa sulla privacy, ed elimina le chiamate di test contenenti dati personali reali quando non sono più necessarie.

Playground

Click on Agent to Start the live call

Check the details

Call Overview

Call Transcription

4. Requisiti legali

Requisiti legali prima di avviare chiamate vocali IA

Le chiamate vocali basate sull’IA sono soggette a normative specifiche dell’UE e italiane. In qualità di titolare del trattamento e deployer del Voice Agent, sei responsabile di quanto segue (vedi il tuo Contratto Spoki e il Data Processing Agreement):

  1. Informa le persone che stanno parlando con un’IA (AI Act UE, Art. 50). Dal 2 agosto 2026, ogni chiamata vocale IA deve dichiarare, alla prima interazione, che l’interlocutore è un sistema di intelligenza artificiale. La piattaforma Spoki supporta questo obbligo tramite il Primo Messaggio — non rimuovere mai questa dichiarazione. Le sanzioni possono arrivare a 15 milioni di euro o al 3% del fatturato mondiale annuo.
  2. Chiama solo contatti con consenso valido (Art. 130 del Codice della Privacy italiano). Le chiamate automatizzate senza operatore umano richiedono il consenso preventivo, specifico e documentato del contatto per le comunicazioni automatizzate. L’iscrizione al Registro Pubblico delle Opposizioni prevale sui consensi precedentemente rilasciati — controlla le tue liste prima di ogni campagna. Possono applicarsi ulteriori restrizioni settoriali (ad es., dal 19 giugno 2026 è vietato il telemarketing non sollecitato di contratti di energia elettrica e gas).
  3. Informa sulla registrazione e trascrizione (GDPR, Artt. 13-14). Le chiamate effettuate tramite Spoki Voice vengono registrate, trascritte e riassunte dall’IA. La tua informativa sulla privacy deve coprire questo trattamento, e l’agente dovrebbe menzionare la registrazione all’inizio della chiamata con un link/riferimento all’informativa completa. Conserva le registrazioni solo per il tempo necessario e limita l’accesso al personale autorizzato.
  4. Utilizza un numero di telefono reale e richiamabile (Delibera AGCOM 106/25/CONS). Le chiamate devono presentare un Caller ID reale che il destinatario possa richiamare. I numeri contraffatti o non identificabili vengono bloccati dagli operatori italiani.
  5. Valuta il rischio prima di un utilizzo su larga scala. Se utilizzi il Voice Agent in modo sistematico o su ampie liste di contatti, effettua una Valutazione d’Impatto sulla Protezione dei Dati (DPIA) con il tuo DPO o consulente privacy.

Spoki (NextAI S.r.l.) agisce come responsabile del trattamento dei dati per queste chiamate e si avvale di Fornitori di Servizi IA selezionati alle condizioni previste dal tuo Contratto e DPA. Un uso improprio del Voice Agent in violazione di queste regole può comportare la sospensione del Servizio ai sensi del Contratto.

Questa sezione è fornita a scopo informativo e non sostituisce una consulenza legale.

5. Automatizzare il flusso della chiamata

Una volta che l’agente è pronto, puoi renderlo parte di un flusso di lavoro più ampio (es. chiamare un lead 5 minuti dopo la compilazione di un modulo).

⚠️ Verifica del consenso: assicurati che il tuo modulo raccolga un consenso opt-in specifico e liberamente espresso per le chiamate vocali automatizzate (separato dal consenso generale per il marketing) prima di attivare l’azione Voice. Conserva la prova del consenso.

  1. Vai su Automazioni e clicca su + Nuovo.
  2. Aggiungi un’Azione e seleziona Spoki Voice.
  3. Ramificazione intelligente: Dopo aver aggiunto l’azione voice, Spoki crea dei rami in base a ciò che è accaduto durante la chiamata:
    • Success (Successo): L’obiettivo è stato raggiunto (es. Appuntamento confermato).
    • Neutral (Neutro): La conversazione è avvenuta ma non è stato raggiunto un esito specifico.
    • Call Me Back (Richiamami): Il cliente ha chiesto di essere ricontattato in seguito.
    • No Answer/Rejected (Nessuna risposta/Rifiutata): Usa questo ramo per inviare automaticamente un messaggio WhatsApp di follow-up.

Step Voice in Automations

Step Voice

6. Conformità e Privacy (GDPR) #

Poiché un Voice Agent registra, trascrive ed elabora la voce delle persone che chiama, tu — in quanto titolare dell’account — sei il titolare del trattamento e sei responsabile del suo utilizzo lecito. Gran parte della conformità quotidiana è integrata direttamente nel tuo prompt.

Nel Primo Messaggio, dichiara sempre, prima di ogni altra cosa, (1) che l’interlocutore è un’IA, (2) chi sta chiamando e perché, e (3) che la chiamata viene registrata. Esempio:

“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?”

Nel System Prompt, aggiungi regole esplicite affinché l’agente rimanga conforme, ad esempio:

Raccogli solo i dati strettamente necessari per l’obiettivo dichiarato.

Se il cliente si oppone alla registrazione, prendine atto cortesemente, non insistere e termina la chiamata.

Non richiedere né registrare dati appartenenti a categorie particolari (salute, religione, opinioni politiche, ecc.). Se il cliente li fornisce spontaneamente, non ripeterli.

What are your Feelings

Share This Article :

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

How can we help?

Updated on September 1, 2026
Get Started with Spoki MCPMicrosoft Dynamics 365 Integration

Powered by BetterDocs

Table of Contents
  • 3. Test nel "Playground"
  • 6. Conformità e 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)