This repository provides a basic Senna.JS example with Channel.me integration.
Integration with Channel.me can be done in 2 ways:
Simply adding an element on the page with the id of wwwchannelme
and a data-code attribute with your client code as the value,
followed by the siteconnect script, is all it takes.
For example:
<p id="wwwchannelme" data-code="your-partner-id">NNNN</p>
<script type="text/javascript" src="//channel.me/siteconnect.js"></script>
Once the page has loaded, the NNNN placeholder will be replaced with
the cobrowse code which can be used from Channel.me's Agent interface.
For more dynamic sites, including Single-Page Applications (SPAs), the process is slightly different.
Firstly, the following block should be added to the end of your
<head> section:
<script
id="wwwchannelme"
type="text/template"></script>
<script
type="text/javascript"
src="//channel.im/siteconnect.js"
data-code="your-partner-id"
defer></script>
Once the siteconnect script has finished loading, it will set the
cobrowse code as the value of the wwwchannelme script tag. You will
need to display this code somewhere on the screen for your visitors.
It will also inject a <div> just before the closing </body> tag. This
div must not be removed when the SPA navigates. Note: if your SPA
replaces the entire contents of the body, please get in touch.
As part of this repository we've provided an example of a Senna.JS integration.
This is the primary html example. Note that in this example we are
mounting the SPA on the body of the page by setting the data-senna
and data-senna-surface attributes there.
Please also note the data-senna-track="permanent" attribute on the
script tags added to the head; this is to ensure this resource
isn't removed incorrectly.
This is where we pick up the injected code and display it on the page.
If you have the Python runtime on your system, you can quickly run this example on your machine.
Simply clone, or download & extract, this repository, change into the directory from your terminal, and run the following command:
$ python3 -m http.server 3333
Then visit http://localhost:3333/ in a browser to see the example running.
We recommend keeping the JavaScript console open in your browser while you navigate the example site to review relevant events and output.
For further support, please contact [email protected].
This code is provided as is and is only intended to be used for illustration purposes. This code is not production-ready and is not meant to be used in a production environment. This repository is to be used as a tool to help customers learn how to integrate with Channel.me's siteconnect script. Any use of this repository or any of its code in a production environment is highly discouraged.