{"id":10045,"date":"2026-02-18T14:24:42","date_gmt":"2026-02-18T14:24:42","guid":{"rendered":"https:\/\/support.spoki.com\/?post_type=docs&p=10045"},"modified":"2026-02-18T14:26:11","modified_gmt":"2026-02-18T14:26:11","password":"","slug":"spoki-voice-integration-guide-whatsapp-phone","status":"publish","type":"docs","link":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/","title":{"rendered":"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone)"},"content":{"rendered":"\n

Spoki Voice allows you to manage voice communications directly within the Spoki platform. You can make and receive calls using a dedicated virtual number and initiate WhatsApp Calls<\/strong> directly from the chat interface.<\/p>\n\n\n\n

This guide covers:<\/p>\n\n\n\n

    \n
  1. Activating the Voice Channel.<\/li>\n\n\n\n
  2. Setting up WhatsApp Call Permissions (Required).<\/li>\n\n\n\n
  3. Making Outbound Calls.<\/li>\n\n\n\n
  4. Receiving Inbound Calls.<\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n

    1. Activation & Getting a Number<\/h2>\n\n\n\n

    To use Spoki Voice, you must first acquire a dedicated phone number.<\/p>\n\n\n\n

      \n
    1. Navigate to Account<\/strong> > Voice<\/strong>.<\/li>\n\n\n\n
    2. You will see a “Welcome to Voice” screen. Click the green Request phone number<\/strong> button.<\/li>\n\n\n\n
    3. Fill in the Representative Details<\/strong> (Name, Address, City, etc.) required for regulatory compliance.<\/li>\n\n\n\n
    4. Review the subscription cost in the Order Summary<\/strong> and complete the payment using your card.<\/li>\n\n\n\n
    5. Once processed, your Status<\/strong> will change to “Active,” and you will see your new Phone Number<\/strong> assigned in the dashboard.<\/li>\n<\/ol>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      For WhatsApp Calls<\/strong>:<\/p>\n\n\n\n

        \n
      1. Navigate to Account<\/strong> > WhatsApp<\/strong><\/strong>.<\/li>\n\n\n\n
      2. Navigate to call tab<\/li>\n\n\n\n
      3. click on activation and then you see the following activation.<\/li>\n<\/ol>\n\n\n\n
        \"\"<\/figure>\n\n\n\n
        \n\n\n\n

        2. WhatsApp Call Permissions (Crucial Step)<\/h2>\n\n\n\n

        To make WhatsApp Calls<\/strong> to your customers, you must strictly follow Meta’s anti-spam policies. You cannot call a user on WhatsApp cold; you must first obtain their permission using a specific template.<\/p>\n\n\n\n

        How to Create a Permission Template:<\/h3>\n\n\n\n
          \n
        1. Go to Templates<\/strong> and click New<\/strong>.<\/li>\n\n\n\n
        2. In the “Set up your template” popup, select the category Call permission request<\/strong>.\n
            \n
          • Note: This specific category is designed to ensure compliance and prevent your number from getting banned.<\/em><\/li>\n<\/ul>\n<\/li>\n\n\n\n
          • Draft your message in the body (e.g., “Would you like to speak with an agent via voice call?”<\/em>).<\/li>\n\n\n\n
          • Submit the template for approval.<\/li>\n<\/ol>\n\n\n\n
            \"\"<\/figure>\n\n\n\n

            The Flow:<\/h3>\n\n\n\n
              \n
            1. Send the Template:<\/strong> Send this “Call permission request” template to the customer via chat.<\/li>\n\n\n\n
            2. User Accepts:<\/strong> The customer must interact\/accept the request.<\/li>\n\n\n\n
            3. Call Unlocked:<\/strong> Once the user accepts, the ability to initiate a WhatsApp call via Spoki is enabled for that contact.<\/li>\n<\/ol>\n\n\n\n
              \n\n\n\n

              3. Making Outbound Calls<\/h2>\n\n\n\n

              Once your number is active and permissions are sorted (for WhatsApp), you can call customers directly from their chat window.<\/p>\n\n\n\n

                \n
              1. Open the Chat<\/strong> with the specific contact.<\/li>\n\n\n\n
              2. Click the Phone Icon<\/strong> (\ud83d\udcde) located at the top right of the chat header.<\/li>\n\n\n\n
              3. Select your desired calling method from the dropdown:\n
                  \n
                • WhatsApp call:<\/strong> (Requires prior user permission). Uses the data network.<\/li>\n\n\n\n
                • Phone call:<\/strong> Uses the standard telephonic network via your Spoki virtual number.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                • In-Call Interface:<\/strong>\n
                    \n
                  • While on the call, a window will appear allowing you to Add notes<\/strong> in real-time.<\/li>\n\n\n\n
                  • You can mute your microphone or put the call on speaker.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                  • Call Log:<\/strong> After the call ends, a summary (and potentially an AI-generated recap, if enabled) will be saved directly in the chat history for future reference.<\/li>\n<\/ol>\n\n\n\n
                    \"\"<\/figure>\n\n\n\n
                    \n\n\n\n

                    4. Inbound Calls<\/h2>\n\n\n\n

                    Your Spoki Voice number is fully functional for incoming traffic as well.<\/p>\n\n\n\n

                      \n
                    • Receiving:<\/strong> When a customer calls your dedicated Spoki number, the call will route to the platform.<\/li>\n\n\n\n
                    • Availability:<\/strong> Ensure your status is set to online\/available to receive these calls.<\/li>\n<\/ul>\n\n\n\n

                      <\/p>\n\n\n\n

                      Here is the updated documentation with the new section on AI Voice Agents<\/strong> added. I have incorporated the details from your new screenshots regarding the Prompt, Voice Config, and Workflow settings.<\/p>\n\n\n\n

                      \n\n\n\n

                      5. AI Voice Agents for Inbound Calls<\/h2>\n\n\n\n

                      You can create an advanced AI Voice Agent to answer incoming calls, handle complex conversations, and transfer calls to human operators when necessary.<\/p>\n\n\n\n

                      A. Creating the Agent & Prompting<\/h3>\n\n\n\n

                      Navigate to the Agents<\/strong> section to configure your bot behavior:<\/p>\n\n\n\n

                        \n
                      1. Agent Name:<\/strong> Give your agent a name.<\/li>\n\n\n\n
                      2. Default Agent:<\/strong> Toggle the Default<\/strong> switch to ON. This ensures this specific agent automatically picks up all inbound calls to your Spoki number.<\/li>\n\n\n\n
                      3. First Message:<\/strong> Define exactly what the agent says immediately when answering (e.g., “Hello, thanks for calling Spoki. How can I help you today?”<\/em>).<\/li>\n\n\n\n
                      4. System Prompt:<\/strong> This is the “brain” of the agent. Describe its personality, role, and the context of the conversation here so it knows how to behave.<\/li>\n<\/ol>\n\n\n\n
                        \"\"<\/figure>\n\n\n\n

                        B. Voice Configuration<\/h3>\n\n\n\n

                        Customize how your agent sounds in the Voice Config<\/strong> tab:<\/p>\n\n\n\n

                          \n
                        1. Language & Persona:<\/strong> Select the appropriate language (e.g., US English, Italian, Spanish) and choose a specific voice persona (e.g., “Francesca” for natural conversations, “Ronald” for a deeper tone).<\/li>\n\n\n\n
                        2. Speed:<\/strong> Use the slider to adjust the speaking rate (Slow, Normal, Fast) to match your brand’s style.<\/li>\n<\/ol>\n\n\n\n
                          \"\"<\/figure>\n\n\n\n

                          C. Workflow & Handling Transfers<\/h3>\n\n\n\n

                          Use the Workflow<\/strong> tab to visually map out how the call should proceed and handle complex situations:<\/p>\n\n\n\n

                            \n
                          • Visual Editor:<\/strong> You have a canvas where you can drag and drop actions starting from the Start<\/strong> node.<\/li>\n\n\n\n
                          • Available Actions:<\/strong>\n
                              \n
                            • Platform Transfer:<\/strong> Automatically transfer the call to a human operator if the user asks for one or if the issue is too complex.<\/li>\n\n\n\n
                            • Agent Transfer:<\/strong> Hand off the call to a different AI agent specialized in another topic.<\/li>\n\n\n\n
                            • End Call:<\/strong> Gracefully terminate the conversation.<\/li>\n\n\n\n
                            • Dispatch Tool:<\/strong> Trigger external tools or integrations during the call.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
                              \"\"<\/figure>\n","protected":false},"excerpt":{"rendered":"

                              Spoki Voice allows you to manage voice communications directly within the Spoki platform. You can make and receive calls using […]<\/p>\n","protected":false},"author":28,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[],"doc_tag":[],"class_list":["post-10045","docs","type-docs","status-publish","hentry"],"year_month":"2026-07","word_count":788,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Ali Varastehranjbar","author_nicename":"alivara","author_url":"https:\/\/support.spoki.com\/en\/author\/alivara\/"},"doc_category_info":[],"doc_tag_info":[],"yoast_head":"\n\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone) - Supporto Spoki<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone) - Supporto Spoki\" \/>\n<meta property=\"og:description\" content=\"Spoki Voice allows you to manage voice communications directly within the Spoki platform. You can make and receive calls using […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/\" \/>\n<meta property=\"og:site_name\" content=\"Supporto Spoki\" \/>\n<meta property=\"article:modified_time\" content=\"2026-02-18T14:26:11+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-scaled.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1347\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/\",\"url\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/\",\"name\":\"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone) - Supporto Spoki\",\"isPartOf\":{\"@id\":\"https:\/\/support.spoki.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-1024x539.png\",\"datePublished\":\"2026-02-18T14:24:42+00:00\",\"dateModified\":\"2026-02-18T14:26:11+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#primaryimage\",\"url\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-1024x539.png\",\"contentUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-1024x539.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/support.spoki.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\/\/support.spoki.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/support.spoki.com\/#website\",\"url\":\"https:\/\/support.spoki.com\/\",\"name\":\"Supporto Spoki\",\"description\":\"Documentation for Spoki use\",\"publisher\":{\"@id\":\"https:\/\/support.spoki.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/support.spoki.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/support.spoki.com\/#organization\",\"name\":\"Supporto Spoki\",\"url\":\"https:\/\/support.spoki.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"contentUrl\":\"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg\",\"width\":2560,\"height\":761,\"caption\":\"Supporto Spoki\"},\"image\":{\"@id\":\"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.linkedin.com\/company\/spokiapp\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone) - Supporto Spoki","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/","og_locale":"en_US","og_type":"article","og_title":"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone) - Supporto Spoki","og_description":"Spoki Voice allows you to manage voice communications directly within the Spoki platform. You can make and receive calls using […]","og_url":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/","og_site_name":"Supporto Spoki","article_modified_time":"2026-02-18T14:26:11+00:00","og_image":[{"width":2560,"height":1347,"url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-scaled.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/","url":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/","name":"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone) - Supporto Spoki","isPartOf":{"@id":"https:\/\/support.spoki.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#primaryimage"},"image":{"@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#primaryimage"},"thumbnailUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-1024x539.png","datePublished":"2026-02-18T14:24:42+00:00","dateModified":"2026-02-18T14:26:11+00:00","breadcrumb":{"@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#primaryimage","url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-1024x539.png","contentUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2026\/02\/Screenshot-2026-02-18-at-14.29.02-1-1024x539.png"},{"@type":"BreadcrumbList","@id":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/support.spoki.com\/en\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/support.spoki.com\/docs\/"},{"@type":"ListItem","position":3,"name":"\ud83d\udcde Spoki Voice: Integration Guide (WhatsApp & Phone)"}]},{"@type":"WebSite","@id":"https:\/\/support.spoki.com\/#website","url":"https:\/\/support.spoki.com\/","name":"Supporto Spoki","description":"Documentation for Spoki use","publisher":{"@id":"https:\/\/support.spoki.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/support.spoki.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/support.spoki.com\/#organization","name":"Supporto Spoki","url":"https:\/\/support.spoki.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/","url":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","contentUrl":"https:\/\/support.spoki.com\/wp-content\/uploads\/2022\/11\/Logo_Spoki-Primary_Black-01-scaled.jpg","width":2560,"height":761,"caption":"Supporto Spoki"},"image":{"@id":"https:\/\/support.spoki.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/spokiapp\/"]}]}},"spoki_translations":{"trid":4982,"translations":{"en":{"id":10045,"url":"https:\/\/support.spoki.com\/en\/docs\/uncategorized\/spoki-voice-integration-guide-whatsapp-phone\/","status":"publish","original":true}}},"_links":{"self":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/10045","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/users\/28"}],"replies":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/comments?post=10045"}],"version-history":[{"count":1,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/10045\/revisions"}],"predecessor-version":[{"id":10094,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/10045\/revisions\/10094"}],"wp:attachment":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/media?parent=10045"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_category?post=10045"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_tag?post=10045"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}