Descripció
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.
Features:
- Setup with a single field: the widget ID.
- The ID is checked when you save: you are told if the widget does not exist or is inactive.
- Place the widget at the bottom right (default) or bottom left of the screen.
- Hide the chat from site administrators.
- Exclude specific paths (for example checkout).
- Compatible with the most common caching plugins.
You need a Scrapia account with a Webchat widget configured.
External services
This plugin relies on an external service: the Scrapia API (https://api.scrapia.ai). The widget does not work without it.
What is sent, and when:
- When you save the settings in the WordPress dashboard, the plugin calls
GET /api/v1/webchat/demo/{widget_id}to confirm that the widget exists. Only the widget ID is sent. - On the front end, the plugin loads
embed.jsfrom 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. - The script stores an anonymous visitor identifier in the browser’s
localStorage, so the conversation continues across pages. - The plugin does not send WordPress account data or the content of the site.
Terms of service: https://scrapia.ai/cl/terminos/
Privacy policy: https://scrapia.ai/cl/politica/
If your site requires consent before cookies or local storage, keep the widget hidden until the visitor accepts by using the scrapia_chat_should_render filter.
Instal·lació
- Upload the
scrapia-webchat-widgetfolder to/wp-content/plugins/, or install the .zip from Plugins Add New. - Activate it from the Plugins screen.
- Go to Settings Scrapia Webchat Widget.
- Paste the widget ID shown in the Scrapia dashboard, under Channels Webchat.
- Save. You should see “Widget connected” with your widget name.
PMF
-
Where do I find the widget ID?
-
In the Scrapia dashboard, under Channels Webchat. It is the same ID shown in the embed code.
-
Can I change the colors or the welcome message from WordPress?
-
No. Those are configured in the Scrapia dashboard and apply to the widget without changing WordPress.
-
Can I show the widget on the left?
-
Yes. In Settings 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.
-
How do I hide it on some pages?
-
In Settings Scrapia Webchat Widget, use the “Excluded paths” field. One path per line, with a trailing
*to include subpaths. -
Can I control it from code?
-
Yes, with the
scrapia_chat_should_renderfilter:add_filter( 'scrapia_chat_should_render', function ( $render ) { if ( is_singular( 'product' ) ) { return false; } return $render; } ); -
The widget does not appear
-
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.
Ressenyes
No hi ha ressenyes per a este complement.
Col·laboradors i desenvolupadors
«Scrapia Webchat Widget» és programari de codi obert. La següent gent ha col·laborat en este complement.
Col·laboradors
Traduïx «Scrapia Webchat Widget» a la teua llengua.
T’interessa el desenvolupament?
Revisa el codi , dona una ullada al repositori SVN o subscriu-te al registre de desenvolupament per RSS.
Registre de canvis
1.1.0
- New: “Position” setting to show the widget at the bottom right (default) or bottom left.
1.0.0
- Initial release.