Stubber Documentation
website·Indexed 33 days ago
https://docs.stubber.com/Documentation for Stubber, featuring guides on Stubmation for batch automation, comprehensive PDF tools for merging, splitting, and converting documents, Handlebars helpers for data substitution, and integration guides for Microsoft Teams and Webchat canvas components.
What's inside Stubber
- Heimdall is an inter-organization event bus system used within the Stubber platform to facilitate communication between different parts of an application or between separate applications. It operates on two primary actions: registering for known events and emitting events.
Overview of the Stubber Framework
The Stubber Framework is a structured method for modeling organizational processes, procedures, and agentic AI applications. It allows developers to define how a process starts, what data is collected at each step, and the actions required to move through the process. Unlike traditional deterministic workflow tools, the framework is non-linear; states represent high-level concepts where multiple potential actions can be triggered in any order and multiple times.Overview of Stubber Email Mailboxes
Stubber Email Mailboxes allow you to send and receive emails using custom addresses (e.g.,advanced-support@org-domain.stubber.email) instead of the defaultStubber Support System<{{stubref}}@stubber.email>address. Unlike Email Profiles, which require external IMAP/SMTP configuration, Email Mailboxes are created directly within Stubber's existing email service, making them easier to set up for inbound routing, reply handling, and mailbox-backed workflows.Overview of StubberDB
StubberDB is a managed PostgreSQL instance provided to every Stubber organization. It automatically synchronizes stub data, allowing users to perform structured querying, reporting, and automation using standard SQL tooling and BI tools without building custom data pipelines.Overview of the API Call task
The API Call task invokes external APIs from a Stubber action and returns the resulting data for use in later tasks. It is primarily used for REST integrations, data lookups, webhooks, and service-to-service automation. It supports all standard HTTP verbs (GET, POST, PUT, DELETE, PATCH) and can handle client certificate authentication and multipart/form-data uploads.Overview of Stubber Webchat advanced configuration
Stubber Webchat provides advanced configuration options to customize the communication and behavior of the chat interface. Key capabilities include:
- Configuring notification parameters for sending messages.
- Implementing control channels for bidirectional communication between a webpage and a stub.
- Customizing interface options for both embedded and hosted implementations.
- Building interactive webchat experiences through custom payloads and client settings.
Overview of Stubber-hosted Webchat Interface
The Stubber-hosted interface is a ready-to-use webchat solution that requires no code integration. It is designed for sharing chat access via direct links or for organizations that need chat capabilities without maintaining their own website.Overview of the Stubber Manage application
The Manage application in Stubber is the central administrative dashboard used to control organization operations. It provides a unified interface for managing users, permissions, billing, credentials, and communication channels. Key administrative areas include:
- Orgs: Create and switch between multiple workspaces, each with independent teams, permissions, and billing.
- Org UUID: Retrieve the unique identifier for the organization required for API calls and integrations.
- Billing: Manage Stubbucks balances, configure automatic top-ups, and retrieve invoices.
- Contacts: Handle user addition and management within the organization.
- Teams: Group users into functional units and assign specific permissions or access to templates and integrations.
- Usage: Analyze Stubbucks consumption metrics by date range and template.
- Notifications: Set up communication channels including Email, Slack, WhatsApp, Facebook Messenger, Telegram, Microsoft Teams, and Webchat.
- Credentials: Securely store API keys, tokens, and authentication details for templates and integrations.
Overview of Agent Link communication
Agent Link allows stubs to communicate as if using an external platform (like WhatsApp).
- Initiator: The stub that starts the conversation. It addresses the agent by
agent_nameorstubrefand must always includestubsession.set_new_with_timeout_hoursto maintain the session. - Agent: The stub receiving the message. It does not have an address for the initiator; instead, it replies by interpolating the
sessionuuidprovided in the incoming message.
Addressing methods:
- Agent Name: A published address (prefixed by the org domain) that works across different organizations. Requires an Agent Link profile.
- Stubref: A direct reference to a stub. This only works within the same organization and requires the receiving stub to opt-in via
_agent_link_configin its stubdata.
- Initiator: The stub that starts the conversation. It addresses the agent by
Overview of Hosted Webchat Canvas Components
Canvas components are UI elements rendered directly within the Stubber-hosted webchat interface. They are used to display complex information or collect user input through rich UI elements such as tables, charts, forms, HTML, iframes, and Mermaid diagrams.Overview of Stubber-Hosted Webchat
Stubber-Hosted Webchat is a fully managed real-time communication tool that can be embedded into any customer website without requiring additional infrastructure. It supports rich media (text, images, files), customizable branding, and integration with Stubber templates and AI assistants.Overview of the manage_stubsession task
Themanage_stubsessiontask provides a unified interface to create, update, or remove stub sessions across different communication platforms. A stub session links a platform conversation (e.g., WhatsApp or Webchat) to a specific stub, ensuring that incoming messages are routed to the correct context. Both supported platforms utilize two core operations:set(to create/update a session) anddelete(to remove a session).