{"id":2297,"date":"2022-11-10T16:36:19","date_gmt":"2022-11-10T16:36:19","guid":{"rendered":"https:\/\/support.spoki.com\/docs\/uncategorized\/how-to-integrate-spoki-for-your-customers-into-your-software\/"},"modified":"2023-11-10T11:33:22","modified_gmt":"2023-11-10T11:33:22","password":"","slug":"how-to-integrate-spoki-for-your-customers-into-your-software","status":"publish","type":"docs","link":"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/","title":{"rendered":"How to integrate Spoki for your customers into your software"},"content":{"rendered":"\n<p><strong>1. Create template and automation Main<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>To get started log in to your Main account on Spoki and create a parent automation that has as a step sending a template<\/li>\n<\/ul>\n\n\n\n<p><strong>2. Create automation and templates in the client&#8217;s Spoki<\/strong> (or secondary)<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Complete the Spoki platform activation process for the client<\/li>\n\n\n\n<li>You will see the new account in the &#8220;Customer Overview&#8221; of your Spoki<\/li>\n\n\n\n<li>Clone the parent automation into the account<\/li>\n\n\n\n<li>This will automatically send the template to WhatsApp for client approval<\/li>\n\n\n\n<li>Creates an API startup step for the automation you just created<\/li>\n\n\n\n<li>A <em><strong>Secret<\/strong> =&gt; <\/em>will be generated for this startup step, copy it and associate it with the user on your DB<\/li>\n<\/ul>\n\n\n\n<p><strong>3. Implement API on Main Account to control whether user can send messages<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ask Spoki support for <em>Agency ID<\/em> and External_API<em>Key<\/em> related to your Main account:<\/li>\n\n\n\n<li>on the Main account implements the<a href=\"https:\/\/documenter.getpostman.com\/view\/21611004\/UzBqnPvF#93c360ca-7f9a-46d8-a517-8d1b551fa9ce\" target=\"_blank\" rel=\"noreferrer noopener\">Retrieve agency API<\/a> which will return all your clients to you with various information including <strong>estimated_available_conversations<\/strong><\/li>\n\n\n\n<li>inviduaiton of the customer via their account ID (which you can also find in the Spoki Customer Overview)<\/li>\n\n\n\n<li><strong>estimated_available_conversations <\/strong>indicates how many new people you can contact with the next step<\/li>\n<\/ul>\n\n\n\n<p><strong>4. Implement the automation startup API in Mooving.<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>at this point you are ready to implement the API that allows you to send the message on behalf of your client so that they send from their number and use their credit<\/li>\n\n\n\n<li>on the Main account implements the<a href=\"https:\/\/documenter.getpostman.com\/view\/21611004\/UzBqnPvF#b3ad8aa9-dd95-4681-879c-3a4bf3aff158\" target=\"_blank\" rel=\"noreferrer noopener\">Start Automation for many contacts API<\/a>: here you can easily start automation for one or more recipients, below is an example <em>template \/ API<\/em>:<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Template<\/strong>:Hello %%FIRST_NAME%%, your subscription will expire on %%DATE_EXPIRE_SCRIPTION%%. Renew it now!<\/p>\n<\/blockquote>\n<\/blockquote>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Bees<\/strong>:{<br>  &#8220;secret&#8221;: &#8220;{{secret}}&#8221;,<br>  &#8220;contacts&#8221;: [<br>  {<br>  &#8220;phone&#8221;: &#8220;+393331234567&#8221;,<br>  &#8220;first_name&#8221;: &#8220;Mario&#8221;,<br>  &#8220;last_name&#8221;: &#8220;Rossi&#8221;,<br>  &#8220;email&#8221;:<a href=\"mailto:mario.rossi@domain.com\" target=\"_blank\" rel=\"noreferrer noopener\">&#8220;mario.rossi@domain.com&#8221;<\/a>,<br>  &#8220;custom_fields&#8221;: {<br>  &#8220;DATA_SCADENZA_ABBONAMENTO&#8221;: &#8220;2022-11-10T18:00:00.000Z&#8221;<br>  }<br>  },<br>  {<br>  &#8220;phone&#8221;: &#8220;+39333123461234&#8221;,<br>  &#8220;first_name&#8221;: &#8220;John&#8221;,<br>  &#8220;last_name&#8221;: &#8220;Bianchi&#8221;,<br>  &#8220;email&#8221;:<a href=\"mailto:giovanni.bianchi@domain.com\" target=\"_blank\" rel=\"noreferrer noopener\">&#8220;giovanni.bianchi@domain.com&#8221;<\/a>,<br>  &#8220;custom_fields&#8221;: {<br>  &#8220;DATA_SCADENZA_ABBONAMENTO&#8221;: &#8220;2022-11-10T18:00:00.000Z&#8221;<br>  }<br>  }<br>  ]<br>}<\/p>\n<\/blockquote>\n<\/blockquote>\n\n\n\n<ul class=\"wp-block-list\">\n<li>sending messages is asynchronous, so the system will return 200 OK to you if it has taken them in, sending will be done by Spoki asynchronously<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Related articles<\/h2>\n\n\n\n<p><a href=\"https:\/\/support.spoki.com\/en\/docs\/integrations\/integrate-spoki-with-any-management-system-via-api\/\" target=\"_blank\" rel=\"noreferrer noopener\">How to start an automation with API<\/a><\/p>\n\n\n\n<p><a href=\"https:\/\/support.spoki.com\/en\/docs\/whatsapp-rules\/rules-to-avoid-ban-from-whatsapp\/\" target=\"_blank\" rel=\"noreferrer noopener\">Rules to avoid ban from WhatsApp<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>1. Create template and automation Main 2. Create automation and templates in the client&#8217;s Spoki (or secondary) 3. Implement API [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[45],"doc_tag":[],"class_list":["post-2297","docs","type-docs","status-publish","hentry","doc_category-how-to-en"],"year_month":"2026-04","word_count":362,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Emanuela Locorotondo","author_nicename":"emanuelalocorotondo","author_url":"https:\/\/support.spoki.com\/en\/author\/emanuelalocorotondo\/"},"doc_category_info":[{"term_name":"How to","term_url":"https:\/\/support.spoki.com\/en\/docs-category\/how-to-en\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How to integrate Spoki for your customers into your software - 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\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to integrate Spoki for your customers into your software - Supporto Spoki\" \/>\n<meta property=\"og:description\" content=\"1. Create template and automation Main 2. Create automation and templates in the client&#8217;s Spoki (or secondary) 3. Implement API [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/\" \/>\n<meta property=\"og:site_name\" content=\"Supporto Spoki\" \/>\n<meta property=\"article:modified_time\" content=\"2023-11-10T11:33:22+00:00\" \/>\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=\"2 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\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/\",\"url\":\"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/\",\"name\":\"How to integrate Spoki for your customers into your software - Supporto Spoki\",\"isPartOf\":{\"@id\":\"https:\/\/support.spoki.com\/#website\"},\"datePublished\":\"2022-11-10T16:36:19+00:00\",\"dateModified\":\"2023-11-10T11:33:22+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/#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\":\"How to integrate Spoki for your customers into your software\"}]},{\"@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":"How to integrate Spoki for your customers into your software - 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\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/","og_locale":"en_US","og_type":"article","og_title":"How to integrate Spoki for your customers into your software - Supporto Spoki","og_description":"1. Create template and automation Main 2. Create automation and templates in the client&#8217;s Spoki (or secondary) 3. Implement API [&hellip;]","og_url":"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/","og_site_name":"Supporto Spoki","article_modified_time":"2023-11-10T11:33:22+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/","url":"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/","name":"How to integrate Spoki for your customers into your software - Supporto Spoki","isPartOf":{"@id":"https:\/\/support.spoki.com\/#website"},"datePublished":"2022-11-10T16:36:19+00:00","dateModified":"2023-11-10T11:33:22+00:00","breadcrumb":{"@id":"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/support.spoki.com\/en\/docs\/how-to-en\/how-to-integrate-spoki-for-your-customers-into-your-software\/#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":"How to integrate Spoki for your customers into your software"}]},{"@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\/"]}]}},"_links":{"self":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/2297","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\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/comments?post=2297"}],"version-history":[{"count":2,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/2297\/revisions"}],"predecessor-version":[{"id":2613,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/docs\/2297\/revisions\/2613"}],"wp:attachment":[{"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/media?parent=2297"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_category?post=2297"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/support.spoki.com\/en\/wp-json\/wp\/v2\/doc_tag?post=2297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}