{"id":383178,"date":"2026-10-11T16:07:18","date_gmt":"2026-10-11T16:07:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/scrapia-webchat-widget\/"},"modified":"2026-10-11T16:25:26","modified_gmt":"2026-10-11T16:25:26","slug":"scrapia-webchat-widget","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/scrapia-webchat-widget\/","author":23582293,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.1.3","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Scrapia Webchat Widget","header_author":"Scrapia","header_description":"Adds the Scrapia AI chat widget to your WordPress site. You only need the widget ID from the Scrapia dashboard.","assets_banners_color":"595870","last_updated":"2026-10-11 16:25:26","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/scrapia.ai","rating":0,"author_block_rating":0,"active_installs":0,"downloads":73,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"carlupi","date":"2026-10-11 16:06:55","revision":3739751},"1.1.0":{"tag":"1.1.0","author":"carlupi","date":"2026-10-11 16:25:26","revision":3739780}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3739780,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3739780,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3739780,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3739780,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[2353,5707,2364,2379,1104],"plugin_category":[41],"plugin_contributors":[285861],"plugin_business_model":[],"class_list":["post-383178","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-live-chat","plugin_tags-support","plugin_category-communication","plugin_contributors-carlupi","plugin_committers-carlupi"],"banners":{"banner":"https:\/\/ps.w.org\/scrapia-webchat-widget\/assets\/banner-772x250.png?rev=3739780","banner_2x":"https:\/\/ps.w.org\/scrapia-webchat-widget\/assets\/banner-1544x500.png?rev=3739780","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/scrapia-webchat-widget\/assets\/icon.svg?rev=3739780","icon":"https:\/\/ps.w.org\/scrapia-webchat-widget\/assets\/icon.svg?rev=3739780","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Scrapia Webchat Widget connects your WordPress site to your Scrapia assistant. The widget appears as a floating button. Colors, avatar, welcome message, and starter buttons are configured in the Scrapia dashboard, not in WordPress.<\/p>\n\n<p>Features:<\/p>\n\n<ul>\n<li>Setup with a single field: the widget ID.<\/li>\n<li>The ID is checked when you save: you are told if the widget does not exist or is inactive.<\/li>\n<li>Place the widget at the bottom right (default) or bottom left of the screen.<\/li>\n<li>Hide the chat from site administrators.<\/li>\n<li>Exclude specific paths (for example checkout).<\/li>\n<li>Compatible with the most common caching plugins.<\/li>\n<\/ul>\n\n<p>You need a Scrapia account with a Webchat widget configured.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin relies on an external service: the Scrapia API (https:\/\/api.scrapia.ai). The widget does not work without it.<\/p>\n\n<p>What is sent, and when:<\/p>\n\n<ul>\n<li>When you save the settings in the WordPress dashboard, the plugin calls <code>GET \/api\/v1\/webchat\/demo\/{widget_id}<\/code> to confirm that the widget exists. Only the widget ID is sent.<\/li>\n<li>On the front end, the plugin loads <code>embed.js<\/code> from the API. That script runs in the visitor's browser and, when the visitor sends a message, sends the message text, an anonymous visitor identifier, and the widget ID to the API. It also loads the history of that conversation.<\/li>\n<li>The script stores an anonymous visitor identifier in the browser's <code>localStorage<\/code>, so the conversation continues across pages.<\/li>\n<li>The plugin does not send WordPress account data or the content of the site.<\/li>\n<\/ul>\n\n<p>Terms of service: https:\/\/scrapia.ai\/cl\/terminos\/\nPrivacy policy: https:\/\/scrapia.ai\/cl\/politica\/<\/p>\n\n<p>If your site requires consent before cookies or local storage, keep the widget hidden until the visitor accepts by using the <code>scrapia_chat_should_render<\/code> filter.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>scrapia-webchat-widget<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install the .zip from Plugins \u2192 Add New.<\/li>\n<li>Activate it from the Plugins screen.<\/li>\n<li>Go to Settings \u2192 Scrapia Webchat Widget.<\/li>\n<li>Paste the widget ID shown in the Scrapia dashboard, under Channels \u2192 Webchat.<\/li>\n<li>Save. You should see \"Widget connected\" with your widget name.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20find%20the%20widget%20id%3F\"><h3>Where do I find the widget ID?<\/h3><\/dt>\n<dd><p>In the Scrapia dashboard, under Channels \u2192 Webchat. It is the same ID shown in the embed code.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20colors%20or%20the%20welcome%20message%20from%20wordpress%3F\"><h3>Can I change the colors or the welcome message from WordPress?<\/h3><\/dt>\n<dd><p>No. Those are configured in the Scrapia dashboard and apply to the widget without changing WordPress.<\/p><\/dd>\n<dt id=\"can%20i%20show%20the%20widget%20on%20the%20left%3F\"><h3>Can I show the widget on the left?<\/h3><\/dt>\n<dd><p>Yes. In Settings \u2192 Scrapia Webchat Widget, set \"Position\" to \"Bottom left\". The default is bottom right. On phones the chat window opens full screen, so only the button changes side.<\/p><\/dd>\n<dt id=\"how%20do%20i%20hide%20it%20on%20some%20pages%3F\"><h3>How do I hide it on some pages?<\/h3><\/dt>\n<dd><p>In Settings \u2192 Scrapia Webchat Widget, use the \"Excluded paths\" field. One path per line, with a trailing <code>*<\/code> to include subpaths.<\/p><\/dd>\n<dt id=\"can%20i%20control%20it%20from%20code%3F\"><h3>Can I control it from code?<\/h3><\/dt>\n<dd><p>Yes, with the <code>scrapia_chat_should_render<\/code> filter:<\/p>\n\n<pre><code>add_filter( 'scrapia_chat_should_render', function ( $render ) {\n    if ( is_singular( 'product' ) ) {\n        return false;\n    }\n    return $render;\n} );\n<\/code><\/pre><\/dd>\n<dt id=\"the%20widget%20does%20not%20appear\"><h3>The widget does not appear<\/h3><\/dt>\n<dd><p>Check that \"Show the chat\" is enabled, that the ID is correct, and, if you are logged in as an administrator, that \"Hide from administrators\" is off.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>New: \"Position\" setting to show the widget at the bottom right (default) or bottom left.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Adds the Scrapia AI chat widget to your WordPress site. You only need the widget ID.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/383178","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=383178"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/carlupi"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=383178"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=383178"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=383178"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=383178"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=383178"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=383178"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}