tap-rilla is a Singer tap for the Rilla Voice API, built with the Meltano SDK for Singer Taps.
Install from source:
uv tool install git+https://github.com/MeltanoLabs/tap-rilla.gitapi_key: The API key to authenticate with the Rilla APIstart_date: The earliest datetime from which to pull data (ISO 8601 format)
end_date: The latest datetime from which to pull data (ISO 8601 format). If not specified, defaults to the current date and time.users: An optional array of user email addresses to filter conversations. Only applies to the conversations stream. If provided and not empty, only conversation data for those users will be returned. If not provided or empty, all conversation data is returned.date_type: Date type to filter by. Options aretimeOfRecordingorprocessedDate. Default:timeOfRecording
Basic configuration:
api_key: your_api_key_here
start_date: '2024-01-01'
end_date: '2024-12-31'Filter conversations for specific users:
api_key: your_api_key_here
start_date: '2024-01-01'
users:
- user1@company.com
- user2@company.comUse processed date instead of recording date:
api_key: your_api_key_here
start_date: '2024-01-01'
date_type: processedDateA full list of supported settings and capabilities is available by running: tap-rilla --about
The tap extracts data from the following Rilla API endpoints:
- Description: Exports conversation data recorded during the specified time range
- Endpoint:
POST /export/conversations - Supports user filtering: Yes (via
usersconfig parameter) - Pagination: Yes (25 records per page)
- Primary Key:
conversationId
- Description: Exports team data and usage during the specified time range
- Endpoint:
POST /export/teams - Supports user filtering: No
- Pagination: No
- Primary Key:
id
- Description: Exports user data and usage during the specified time range
- Endpoint:
POST /export/users - Supports user filtering: No
- Pagination: No
- Primary Key:
id
All streams support the date_type parameter with timeOfRecording as the default. You can optionally set date_type: processedDate to filter by processing date instead of recording date.
You can easily run tap-rilla with the included meltano.yml project file.
- Create a
.envfile with your API key:
TAP_RILLA_API_KEY=your_api_key_here- Install Meltano and the tap:
uv tool install meltano
meltano install- Test the tap:
meltano run tap-rilla target-jsonltap-rilla --version
tap-rilla --help
tap-rilla --config CONFIG --discover > ./catalog.jsonuv syncmeltano run tap-rilla target-jsonlSee the dev guide for more instructions on how to develop and test this tap.