Datalumo
Docs · Getting started
View markdown

Getting started

From an empty account to search or chat on your site.

Signup creates a Default knowledge base for you. You add a source, wait until it is Ready, then create a widget and paste a snippet.

If you run WordPress, Shopify, or Laravel, start with that integration instead. Those packages sync content and can place the widgets for you.

#1. Add content

In the dashboard, open your knowledge base and add a source. See Ingestion for every method.

A knowledge base can mix sources. Add the ones that hold the answers visitors will ask for.

#2. Wait until Ready

Opening the source shows progress while pages are read and embedded. Leave the page open if you like. It updates live.

A finished crawl or upload is not the same as Ready. Search and chat only use pages that have finished indexing.

#3. Create a widget

From the knowledge base, create a chat widget or a search widget. Point it at the sources it should use.

On Setup, add the domain of the site that will host the embed (for example example.com). Browser requests are authorised by that origin.

#4. Paste the snippet

The widget's Install tab has a ready-made snippet. Paste it before </body>.

Chat bubble:

<script src="https://datalumo.app/widget/v1/datalumo.js"></script>
<script>
  Datalumo.chat('ORG_ID/WIDGET_ID').mount();
</script>

Search box:

<div id="search" style="min-height: 2.5rem"></div>
<script src="https://datalumo.app/widget/v1/datalumo.js"></script>
<script>
  Datalumo.search('ORG_ID/WIDGET_ID', { target: '#search' }).mount();
</script>

The key looks like {organisation}/{widget}. It is safe to put in HTML.

For variants, identity, and headless mode, see Install.

#What you'll need

  • A Datalumo account. The first 100 answers are free.
  • At least one source with content.
  • The site domain added on the widget.

#Next