Reecall
Core Concepts

Workflows & Hooks

A Workflow combines actions such as calling an API, processing data with AI, and sending messages. Use it for integration work that follows a defined sequence, including actions after a conversation.

Steps and context

Each step has a type that selects its action and a config object with its settings. Steps run in order within a sequence. A step can save its result in context for later steps to use.

For example, a Workflow can fetch a customer record, generate a summary with an Agent step, and send the result by email. Rules choose a branch, Batch runs independent actions in parallel, and Map runs steps for each item in a list.

See Workflows for the step types and Context manipulation for how data passes between steps.

Processes and Hooks

A Process stores a Workflow's steps as a reusable resource. A Hook links a Process to an entity and a set of events. When a matching event occurs in the Hook's Project, Reecall runs the linked Process with the entity data as context.

ResourceDefines
WorkflowThe steps to execute and how they use context
ProcessA stored set of workflow steps
HookWhich entity events trigger a Process

You can also send Workflow steps directly to the execution endpoint. A Hook is needed when execution should follow an entity event automatically.

After a conversation

For a post-conversation integration, register a Hook for conversational.exchange and the UPDATE event. The Process should check that the Exchange has status: "completed" before using its final data.

To handle calls where startup registration failed and Reecall creates the completed Exchange at the end, subscribe to both CREATE and UPDATE. Keep the completed-status check so the normal startup event does not trigger the follow-up actions.

See Post-conversation processing for the configuration and payloads.

Blueprints provision resources

A Blueprint creates related resources from templates in one transaction. For example, it can provision an Assistant, its Knowledge Base, and its Channel together. If an insert fails, the transaction rolls back.

Use Workflows to execute integration actions. Use Blueprints to repeat a resource setup for new customers or Projects.

Next steps

Last modified on