tap-asyntai-chatbot-chatbot

A Singer tap for Asyntai.

Asyntai is an AI chatbot that answers visitor questions on your website. This tap loads what happens in those chats into your own warehouse, so the chat data sits next to your sales and product data.

Streams

messages.session_id joins to sessions.session_id, and so do leads and tickets, so the four tables model one conversation together.

Installation

pipx install tap-asyntai-chatbot

Or with Meltano:

meltano add extractor tap-asyntai-chatbot

Configuration

Get the API key in the Asyntai dashboard under Settings, then API. The API needs the Starter plan or higher.

tap-asyntai-chatbot --config config.json

A minimal config.json:

{
  "api_key": "your-asyntai-api-key",
  "start_date": "2026-01-01T00:00:00Z"
}

Usage with Meltano

plugins:
  extractors:
    - name: tap-asyntai-chatbot
      namespace: tap_asyntai_chatbot
      pip_url: tap-asyntai-chatbot
      capabilities: [catalog, state, discover, about, stream-maps]
      settings:
        - name: api_key
          kind: password
        - name: api_url
        - name: start_date
          kind: date_iso8601
        - name: website_id
        - name: page_size
          kind: integer

meltano config tap-asyntai-chatbot set api_key $ASYNTAI_API_KEY
meltano run tap-asyntai-chatbot target-postgres

How paging works

Every list endpoint of the Asyntai API sorts newest first and filters on the same field it sorts by. The tap sends the oldest value of one page as the exclusive before bound of the next one, which is the paging scheme the API documents. since carries the bookmark, so a second run reads only new rows.

Developing

pip install -e ".[dev]"
pytest
tap-asyntai-chatbot --about

License

Apache 2.0