# Home: English Documentation User Guide ## User Guide ### Get Started - [Welcome to Treble](https://help.treble.ai/en/docs/welcome.md): Treble is a tool that allows you to create customized conversation flows for your WhatsApp sales and marketing use cases. Additionally, Treble can be integrated with your information systems (CRM) like HubSpot and Salesforce to automate and optimize your WhatsApp messaging processes. - [Key Concepts](https://help.treble.ai/en/docs/key-concepts.md): This guide introduces key Treble concepts such as conversations, blocks, templates, and more. #### Introduction to Treble - [Getting Started](https://help.treble.ai/en/docs/intro-to-treble/welcome.md): This guide introduces Treble's business capabilities, the platform for developing with Treble, and how to start building. - [Outbound Conversation](https://help.treble.ai/en/docs/intro-to-treble/outbound-convo.md): Learn how to create an outbound conversation in Treble. - [Inbound Conversation](https://help.treble.ai/en/docs/intro-to-treble/inbound-convo.md): Learn how to create an inbound conversation in Treble. - [Tutorial: First Conversation Transferred to an Agent](https://help.treble.ai/en/docs/intro-to-treble/first-agent-convo.md): Learn how to create an inbound conversation where your users write to you and transfer it to an agent on your team in Treble. ### Meta - [Meta and Treble](https://help.treble.ai/en/docs/meta/overview.md): Understand everything about Treble, Meta, and WhatsApp - [WhatsApp, WhatsApp Business, and WhatsApp Business API](https://help.treble.ai/en/docs/meta/wa-wabiz-api.md): Understand everything about WhatsApp, WhatsApp Business, and WhatsApp Business API - [Green Check WhatsApp Line](https://help.treble.ai/en/docs/meta/green-check.md): The Green Check is a green badge displayed on the WhatsApp line, indicating that the account has been verified by Meta. - [WhatsApp Line Health](https://help.treble.ai/en/docs/meta/whatsapp-line-health.md): Learn how to maintain the health of your WhatsApp line. With this guide, you'll be able to keep your line in good condition and avoid penalties. - [WhatsApp Business Platform Policies](https://help.treble.ai/en/docs/meta/waba-policies.md): Understand everything about WhatsApp Business Platform policies - [WhatsApp Usernames & Business-Scoped User IDs (BSUID)](https://help.treble.ai/en/docs/meta/usernames-and-bsuid.md): Meta is changing how WhatsApp contacts are identified. Here's what a BSUID and a WhatsApp username are, what changes for your inbound and outbound messages, and how Treble handles it for you. #### Connect WhatsApp Line - [Connect WhatsApp Line](https://help.treble.ai/en/docs/meta/guide/welcome.md): Learn all the steps and requirements from Meta to connect your own WhatsApp number to Treble.ai. - [Prepare your website](https://help.treble.ai/en/docs/meta/guide/preparing-website.md): We recommend that you prepare your website so you can connect your WhatsApp number to Treble.ai. - [Meta Business Portfolio](https://help.treble.ai/en/docs/meta/guide/business-manager.md): Learn how to create your Meta Business Portfolio to connect your WhatsApp number to Treble.ai. - [Meta Verification](https://help.treble.ai/en/docs/meta/guide/meta-verification.md): Learn how to verify your Meta account to connect your WhatsApp number to Treble.ai. - [WhatsApp Number](https://help.treble.ai/en/docs/meta/guide/whatsapp-number.md): You are in the final step to connect your WhatsApp number to Treble.ai. Here we explain how to prepare the phone number that you will use for your WhatsApp Business API. #### Message Templates (HSM) - [HSM Templates](https://help.treble.ai/en/docs/meta/hsm-templates/intro.md): Learn what HSM templates are and how to use them - [Utility Templates](https://help.treble.ai/en/docs/meta/hsm-templates/utility.md): Learn what utility templates are and how to use them - [Carousel Templates](https://help.treble.ai/en/docs/meta/hsm-templates/carousel.md): Send multiple cards with image or video, text and buttons in a single WhatsApp message #### WhatsApp Errors - [Failure by unable to contact in WhatsApp](https://help.treble.ai/en/docs/meta/error-descriptions/failure-by-unable-to-contact.md): Description of the `FAILURE_BY_UNABLE_TO_CONTACT` error shown in WhatsApp reports. - [Failure by payment issue in WhatsApp](https://help.treble.ai/en/docs/meta/error-descriptions/failure-by-payment-issue.md): Description of the `FAILURE_BY_PAYMENT_ISSUE` error (Meta code 131042) shown in WhatsApp reports, and what to do if you see it. ### Build with Treble - [Campaign Objective](https://help.treble.ai/en/docs/build-with-treble/welcome.md): Learn how to create your conversations in Treble thinking about your campaign objectives #### Features - [Variables](https://help.treble.ai/en/docs/build-with-treble/features/variables.md): Variables are a critical part of Treble. They allow you to personalize messages and actions in your conversations. Additionally, they allow you to store information in your information systems or use it in different parts of a conversation flow. - [Native Variables](https://help.treble.ai/en/docs/build-with-treble/features/native-variables.md): Native variables are variables that come pre-configured in Treble. These allow you to access important information in your conversation flows such as the country code of the customer's phone number, the message used by your customer to start an inbound conversation flow, or even the current week num… - [Alternate Flow](https://help.treble.ai/en/docs/build-with-treble/features/alternate-flow.md): Learn how to use Treble's alternate flow. A functionality available in each message block that can be activated so the system automatically advances to the next question or sends a new message after a predefined time interval. - [Second HSM](https://help.treble.ai/en/docs/build-with-treble/features/second-hsm.md): Learn how to use Treble's second HSM - [Goal Block](https://help.treble.ai/en/docs/build-with-treble/features/goal-block.md): The goal block functionality allows you to define measurable goals for your WhatsApp conversation - [Images, documents and videos in your message blocks](https://help.treble.ai/en/docs/build-with-treble/features/media.md): Learn how to add images, documents and videos to your message blocks so your customers can see visual content or if you want to send them documents or videos. #### Blocks - [A/B Testing](https://help.treble.ai/en/docs/build-with-treble/blocks/ab-test.md): Learn how to use the A/B Testing block in Treble - [Transfer to Agent](https://help.treble.ai/en/docs/build-with-treble/blocks/agent.md): Learn how to use the Transfer to Agent block in Treble - [WhatsApp Flows](https://help.treble.ai/en/docs/build-with-treble/blocks/whatsapp-flows.md): Learn how to create WhatsApp flows with Treble. With this guide, you'll be able to automate your customer conversations and improve the user experience. - [📣 Meta Events — Measure What Matters](https://help.treble.ai/en/docs/build-with-treble/blocks/meta-events.md): This page explains how to use the Meta Events node within Treble’s conversation builder. This node allows customers to send key events (such as purchases, order creation, or shipments) to Meta’s Conversions API, as long as the conversation was initiated from a Click to WhatsApp ad. It outlines the s… - [Message Blocks - Buttons, Interactive List, Simple and with Options](https://help.treble.ai/en/docs/build-with-treble/blocks/message-blocks.md): Message blocks are used as the fundamental foundation for creating conversation flows in Treble.ai. These are used to display information, ask questions, receive responses and more. Learn to use message blocks to create personalized conversation flows. - [Conditional Block](https://help.treble.ai/en/docs/build-with-treble/blocks/conditional.md): The conditional block allows you to make decisions based on user responses, native variables and custom variables to direct the flow of a Treble conversation. Learn to use this block to create intelligent and personalized conversation flows. - [Jump to Conversation Block](https://help.treble.ai/en/docs/build-with-treble/blocks/jump-to-conversation.md): The jump to conversation block allows you to redirect the flow of a conversation to another Treble conversation. This is useful if you have a message flow that you want to be carried out across multiple conversations or if you want a customer to be able to continue a conversation in another conversa… ##### Transfer Methods - [Transfer Methods](https://help.treble.ai/en/docs/build-with-treble/blocks/transfer-methods/overview.md): Define how each conversation is assigned to an agent from the block itself, instead of once for your whole company. Choose between Treble's methods, HubSpot's methods, or let your own API decide which agent receives the chat. - [Treble Methods](https://help.treble.ai/en/docs/build-with-treble/blocks/transfer-methods/treble.md): Assign the conversation to an agent on your team in treble.sales.ai: to the one with the fewest active chats, to a random one, or always to the same specific agent. - [HubSpot Methods](https://help.treble.ai/en/docs/build-with-treble/blocks/transfer-methods/hubspot.md): Assign the conversation to the contact's owner agent in HubSpot —immediately, with a wait time limit, or only if they're connected— or to a team, and sync the assignment with your HubSpot workflows. - [API Assignment](https://help.treble.ai/en/docs/build-with-treble/blocks/transfer-methods/api.md): Let your own system decide which agent receives each conversation. Treble calls the endpoint you configure with the chat's context and assigns the conversation to the agent you return. #### Guides - [Schedule and Time Configuration](https://help.treble.ai/en/docs/build-with-treble/guides/schedules-and-time-configuration.md): Learn how to configure business hours, timezone and time condition handling in your treble conversations. - [How to Measure Your Link Performance](https://help.treble.ai/en/docs/build-with-treble/guides/measure-links.md): If you have links in your messages, you can easily measure your link performance. Learn how to do it in this guide. ### Main Platform - [Understanding the Main Platform](https://help.treble.ai/en/docs/main-platform/welcome.md): The Treble main platform is the platform that allows you to create and manage your WhatsApp conversations. - [Conversation Flow Editor](https://help.treble.ai/en/docs/main-platform/conversation-editor.md): In the conversation flow editor you can design, configure and connect message blocks to create the automated flow of your conversation in Treble. - [Send Outbound Conversation](https://help.treble.ai/en/docs/main-platform/send-convo.md): Learn how to send your outbound conversations to your customers and the different ways to do it. - [Contacts](https://help.treble.ai/en/docs/main-platform/contacts.md): Treble includes a built-in lightweight CRM that centralizes all your WhatsApp contacts in one place. Learn how to manage contacts, custom properties, lists, and bulk actions. - [Treble Link Shortener](https://help.treble.ai/en/docs/main-platform/link-shortener.md): Treble has a native link shortener designed to make it easier to share URLs with your customers. - [Conversation Metrics](https://help.treble.ai/en/docs/main-platform/conversation-metrics.md): Learn to understand your conversation results through the conversation metrics section. - [WhatsApp Links](https://help.treble.ai/en/docs/main-platform/whatsapp-links.md): Learn how to use WhatsApp links in Treble. These are links that allow you to measure the performance of your marketing and sales campaigns. - [Analytics Center](https://help.treble.ai/en/docs/main-platform/analytics-center.md): The Analytics Center is where you can explore and access structured data from your WhatsApp activity on Treble. It is designed for teams that want greater autonomy and clarity in understanding user engagement, campaign effectiveness, and operational performance. This page introduces two foundationa… - [Settings Section](https://help.treble.ai/en/docs/main-platform/settings.md): The Settings section is where you can configure your Treble account, your preferences and some general settings for your conversation flows. Learn how to use the Settings section to customize your account and your conversation flows. - [Knowledge Base](https://help.treble.ai/en/docs/main-platform/knowledge-base.md) #### AI Agents - [Introduction](https://help.treble.ai/en/docs/main-platform/ai-center/overview.md): Create AI agents by describing what you need and automate your WhatsApp conversations end to end. - [Create an agent](https://help.treble.ai/en/docs/main-platform/ai-center/create-agent.md): Describe what you need in your own words and Treble writes the instructions, picks the tools and builds your AI agent. - [Configure your agent](https://help.treble.ai/en/docs/main-platform/ai-center/configure-agent.md): Adjust the instructions, complete the pending tools and define your agent's behavior before publishing it. - [Test your agent](https://help.treble.ai/en/docs/main-platform/ai-center/playground.md): Validate and optimize your AI agent in the playground and with a real WhatsApp conversation before putting it into production. - [Knowledge Base](https://help.treble.ai/en/docs/main-platform/ai-center/knowledge-base.md): Learn how to structure an effective knowledge base to maximize the performance of your AI agents ##### Agents ###### AI Agent - [Introduction](https://help.treble.ai/en/docs/main-platform/ai-center/agents/ai-agent/overview.md): AI agent capable of holding a natural conversation and taking autonomous actions using tools. - [API Call Tool](https://help.treble.ai/en/docs/main-platform/ai-center/agents/ai-agent/api-tool.md): How to configure and use the API calling tool - [Google Calendar Integration](https://help.treble.ai/en/docs/main-platform/ai-center/agents/ai-agent/google-calendar.md): Connect Google Calendar to the AI Task Automator and let the agent schedule, reschedule, or cancel appointments automatically. - [Setting up Shopify Integration](https://help.treble.ai/en/docs/main-platform/ai-center/agents/ai-agent/shopify-install.md): Follow these steps to set up the Shopify integration in Treble. - [How to use Shopify in your conversations](https://help.treble.ai/en/docs/main-platform/ai-center/agents/ai-agent/shopify-usage.md): Follow these steps to use Shopify in your conversations. ###### Legacy agents - [Take your customers to a goal](https://help.treble.ai/en/docs/main-platform/ai-center/agents/objective-ai.md): Create AI agents that guide your contacts toward specific goals like scheduling appointments or making purchases - [Lead Qualification](https://help.treble.ai/en/docs/main-platform/ai-center/agents/lead-qualification.md): Automate lead qualification 24 hours a day with AI that collects data and saves it directly to your CRM ### Agent Platform - [Understanding the Agent Platform](https://help.treble.ai/en/docs/agent-platform/welcome.md): In this article, you will learn about the most important elements of Treble's agent platform, with the aim of helping you and your team take full advantage of it and achieve effective communication with your customers. - [Main View](https://help.treble.ai/en/docs/agent-platform/main-platform.md): Let's learn how to use Treble's main view to respond to conversations as an agent and some of the tools you can use. - [Contacts Section](https://help.treble.ai/en/docs/agent-platform/contacts.md): Learn how to get the most out of this section. Learn how to add contacts, start a new conversation, or check the history of a past conversation. - [Mobile App for Agents](https://help.treble.ai/en/docs/agent-platform/mobile-app.md): Discover treble's mobile app, a tool that keeps your agents connected and productive at all times, ensuring smooth and efficient communication with customers from anywhere. - [How to Sort and Filter Conversations](https://help.treble.ai/en/docs/agent-platform/filters.md): Learn how to use treble.ai's chat view to work with focus, track conversations, and never miss an important interaction. - [Push Notifications Setup](https://help.treble.ai/en/docs/agent-platform/notifications.md): Enable platform push notifications by configuring both your browser and system settings. This guide will help you properly set up notifications on desktop (Mac and Windows) and mobile devices (Android and iOS). - [Automatic Inactivity Detection](https://help.treble.ai/en/docs/agent-platform/inactivity.md): Configure Treble to automatically detect when an agent stops responding and mark them as inactive, preventing conversations from going unattended. - [SLA Automations](https://help.treble.ai/en/docs/agent-platform/sla-automations.md): Create rules that monitor your conversation response times and run automatic actions when a threshold is exceeded: send a message, notify by email or webhook, change an agent's status or start a Treble conversation. #### Admin - [Administrator Section](https://help.treble.ai/en/docs/agent-platform/admin/admin-section.md): In the administrator section, you can see the status of your conversations, see which agents have conversations assigned, and use filters to view conversations. - [Metrics](https://help.treble.ai/en/docs/agent-platform/admin/metrics.md): In the metrics section, you can see the metrics of your conversations, agents, and groups. This will help you understand the state of your operation in greater detail. - [Agents](https://help.treble.ai/en/docs/agent-platform/admin/agents.md): In the agents section, you can view your operation's agents, their metrics, and their conversations. You can manage your agents, assign roles, create teams, and more. - [Agent Teams](https://help.treble.ai/en/docs/agent-platform/admin/tags-teams.md): With Treble, you can create agent teams so your advisors can work together on your customers' conversations. - [Quick Response Templates](https://help.treble.ai/en/docs/agent-platform/admin/quick-responses.md): Quick response templates are predefined messages that you can use to respond to your customers quickly and efficiently. This allows your agents to select a quick response and send it to your customers. - [AI - Intelligent Assistants](https://help.treble.ai/en/docs/agent-platform/admin/treble-boost.md): Treble Boost is an AI that allows you to create intelligent assistants for your sales conversations. When creating an intelligent assistant, you can define the AI behavior, such as the type of conversation, language, tone, etc. This allows your agents to respond to your customers' conversations more… - [Configuration](https://help.treble.ai/en/docs/agent-platform/admin/configuration.md): From this panel you can manage the contacts visible to agents, control the use of HSM message templates, customize the HubSpot properties displayed in the chat, and define conversation assignment rules. - [Recommendations and FAQs](https://help.treble.ai/en/docs/agent-platform/admin/tips-and-questions.md): In this section, you can find recommendations and frequently asked questions about the Treble agent platform. ### Integrations - [Integrations](https://help.treble.ai/en/docs/integrations/welcome.md): Treble integrates with your information systems like HubSpot and Salesforce to automate and optimize your WhatsApp messaging processes. Discover how you can integrate Treble with your CRM or other information systems. #### HubSpot - [HubSpot Integration](https://help.treble.ai/en/docs/integrations/hubspot/welcome.md): This guide shows you how to integrate Treble with HubSpot. - [Install Treble in HubSpot](https://help.treble.ai/en/docs/integrations/hubspot/install.md): In this guide, learn how to integrate Treble with HubSpot. This is something you only need to do once. Once configured, Treble will help you leverage the full potential of WhatsApp to sell more through your integration. ##### Features - [Workflows](https://help.treble.ai/en/docs/integrations/hubspot/features/workflows.md): Learn how to create workflows in HubSpot to automate sending your Treble and WhatsApp conversations. - [Variables](https://help.treble.ai/en/docs/integrations/hubspot/features/variables.md): This guide shows you how to update and use properties of your HubSpot contacts within your Treble conversations. This will allow you to create more personalized and automated conversations. - [HubSpot properties in Treble](https://help.treble.ai/en/docs/integrations/hubspot/features/properties.md): Why sometimes you do not see a newly created property and how to refresh the HubSpot property list inside Treble. - [Deploy Conversation from Contact Profile](https://help.treble.ai/en/docs/integrations/hubspot/features/deploy.md): Learn how to deploy Treble conversations directly from the Contact view within HubSpot. - [Chat History in HubSpot as Notes](https://help.treble.ai/en/docs/integrations/hubspot/features/chat-history.md): Conversations with your customers are now recorded as Notes on their HubSpot contact, so the full chat history is visible without leaving HubSpot. - [HSM Status Updates as Timeline Activities](https://help.treble.ai/en/docs/integrations/hubspot/features/hsm-status.md): HSMs sent to customers with a HubSpot contact now create timeline activities flagging when they are sent, delivered, or fail. ##### Blocks - [CRM Action Block](https://help.treble.ai/en/docs/integrations/hubspot/blocks/crm-action.md): Update and create HubSpot contacts, deals, companies and tickets from a Treble conversation. - [CRM Object Block](https://help.treble.ai/en/docs/integrations/hubspot/blocks/crm-variable-assignment.md): Read a property from a HubSpot contact, deal, company or ticket and save it into a variable to use it inside the conversation. - [Ticket Block](https://help.treble.ai/en/docs/integrations/hubspot/blocks/ticket.md): Learn how to use Treble's ticket block. This block allows you to create a ticket in HubSpot based on the customer's response. You can configure the ticket with multiple properties. - [Conditional Block](https://help.treble.ai/en/docs/integrations/hubspot/blocks/conditional.md): Learn to use Treble's conditional block. This block allows you to change the flow of a conversation based on the contact's properties in HubSpot. - [Human Transfer Block](https://help.treble.ai/en/docs/integrations/hubspot/blocks/human-transfer.md): Learn in this guide how to use the human transfer block in Treble. This block allows your conversations to be transferred to a human agent. Your team of agents will be able to respond to these conversations directly from HubSpot. ##### HubSpot + AI - [HubSpot AI Integration](https://help.treble.ai/en/docs/integrations/hubspot/hubspot-ai/welcome.md): This guide shows you how to integrate Treble with HubSpot and the AI functionality - [Installing the HubSpot AI Integration](https://help.treble.ai/en/docs/integrations/hubspot/hubspot-ai/installation.md): This guide shows you how to install the Treble integration with HubSpot. - [HubSpot AI Integration Features](https://help.treble.ai/en/docs/integrations/hubspot/hubspot-ai/features.md): This guide shows you how to use the features of the Treble integration with HubSpot. - [HubSpot AI integration use case examples](https://help.treble.ai/en/docs/integrations/hubspot/hubspot-ai/examples.md): This guide gives you some scenario recipes and use cases for the Treble integration with HubSpot. #### Salesforce - [Salesforce Integration](https://help.treble.ai/en/docs/integrations/salesforce/welcome.md): This guide shows you how to integrate Treble with Salesforce. ##### Salesforce AI - [Salesforce AI Integration](https://help.treble.ai/en/docs/integrations/salesforce/salesforce-ai/welcome.md): This guide shows you how to integrate Treble with Salesforce and the AI functionality - [Installing the Salesforce AI Integration](https://help.treble.ai/en/docs/integrations/salesforce/salesforce-ai/installation.md): This guide shows you how to install the Treble integration with Salesforce. - [Salesforce AI Integration Features](https://help.treble.ai/en/docs/integrations/salesforce/salesforce-ai/features.md): This guide shows you how to use the features of the Treble integration with Salesforce. - [Salesforce AI integration use case examples](https://help.treble.ai/en/docs/integrations/salesforce/salesforce-ai/examples.md): This guide gives you some scenario recipes and use cases for the Treble integration with Salesforce. #### Sheets - [Treble.ai Integration with Google Sheets](https://help.treble.ai/en/docs/integrations/sheets/welcome.md): Connect your conversations with spreadsheets to automatically save and update data. - [Frequently Asked Questions](https://help.treble.ai/en/docs/integrations/sheets/faq.md): Here are some of the most frequently asked questions and their answers about our Google Sheets integration. #### Zoho - [Zoho Integration](https://help.treble.ai/en/docs/integrations/zoho/welcome.md): This guide shows you how to integrate Treble with Zoho. - [Installing the Zoho Integration](https://help.treble.ai/en/docs/integrations/zoho/installation.md): This guide shows you how to install the Treble integration with Zoho. - [Zoho Integration Features](https://help.treble.ai/en/docs/integrations/zoho/features.md): This guide shows you how to use the features of the Treble integration with Zoho. - [Zoho integration use case examples](https://help.treble.ai/en/docs/integrations/zoho/examples.md): This guide gives you some scenario recipes and use cases for the Treble integration with Zoho. #### Pipedrive - [Pipedrive Integration](https://help.treble.ai/en/docs/integrations/pipedrive/welcome.md): This guide shows you how to integrate Treble with Pipedrive. - [Installing the Pipedrive Integration](https://help.treble.ai/en/docs/integrations/pipedrive/installation.md): This guide shows you how to install the Treble integration with Pipedrive. - [Pipedrive Integration Features](https://help.treble.ai/en/docs/integrations/pipedrive/features.md): This guide shows you how to use the features of the Treble integration with Pipedrive. - [Pipedrive integration use case examples](https://help.treble.ai/en/docs/integrations/pipedrive/examples.md): This guide gives you some scenario recipes and use cases for the Treble integration with Pipedrive. #### Active Campaign - [Active Campaign Integration](https://help.treble.ai/en/docs/integrations/activecampaign/welcome.md): This guide shows you how to integrate Treble with Active Campaign. - [Installing the Active Campaign Integration](https://help.treble.ai/en/docs/integrations/activecampaign/installation.md): This guide shows you how to install the Treble integration with Active Campaign. - [Active Campaign Integration Features](https://help.treble.ai/en/docs/integrations/activecampaign/features.md): This guide shows you how to use the features of the Treble integration with Active Campaign. - [Active Campaign integration use case examples](https://help.treble.ai/en/docs/integrations/activecampaign/examples.md): This guide gives you some scenario recipes and use cases for the Treble integration with Active Campaign. ### Analytics Warehouse - [Analytics Warehouse](https://help.treble.ai/en/docs/data-warehouse-v2/welcome.md): Query your Treble data in near real time with SQL — full history, richer detail, and a stable naming contract. - [Dimensions](https://help.treble.ai/en/docs/data-warehouse-v2/dimensions.md): Catalog tables for enriching your fact queries: agents, teams, templates, flows, channels, and flow nodes. #### Using the Warehouse - [Migration Guide](https://help.treble.ai/en/docs/data-warehouse-v2/migration-guide.md): Move your queries from the legacy Data Warehouse (client_analytics) to the Analytics Warehouse. - [Incremental Sync](https://help.treble.ai/en/docs/data-warehouse-v2/incremental-sync.md): Keep a copy of your Treble data in your own systems, reliably, using the synced_at watermark. - [Query Optimization](https://help.treble.ai/en/docs/data-warehouse-v2/query-optimization.md): How to write fast, efficient queries against the Analytics Warehouse. #### Conversation Flows - [fact_treble_sessions](https://help.treble.ai/en/docs/data-warehouse-v2/fact-treble-sessions.md): One row per conversation flow execution, inbound or outbound. - [fact_treble_session_messages](https://help.treble.ai/en/docs/data-warehouse-v2/fact-treble-session-messages.md): Every message exchanged inside conversation flows — the full trace. - [fact_treble_session_nodes](https://help.treble.ai/en/docs/data-warehouse-v2/fact-treble-session-nodes.md): The node-by-node journey of every conversation through its flow. - [fact_treble_session_variables](https://help.treble.ai/en/docs/data-warehouse-v2/fact-treble-session-variables.md): Variables captured or set during each conversation flow. #### Campaigns - [fact_campaign_sends](https://help.treble.ai/en/docs/data-warehouse-v2/fact-campaign-sends.md): Every outbound campaign message with its full delivery lifecycle. - [fact_campaign_daily](https://help.treble.ai/en/docs/data-warehouse-v2/fact-campaign-daily.md): Pre-aggregated daily delivery metrics per campaign. - [fact_hsm_responses](https://help.treble.ai/en/docs/data-warehouse-v2/fact-hsm-responses.md): Answers users gave to HSM template questions. #### Agent Workspace - [fact_agent_conversations](https://help.treble.ai/en/docs/data-warehouse-v2/fact-agent-conversations.md): Conversations handled by human agents in the agent workspace. - [fact_agent_conversation_messages](https://help.treble.ai/en/docs/data-warehouse-v2/fact-agent-conversation-messages.md): Every message exchanged inside agent conversations. - [fact_agent_conversation_transfers](https://help.treble.ai/en/docs/data-warehouse-v2/fact-agent-conversation-transfers.md): Every transfer of a conversation between agents or teams. - [fact_agent_status_changes](https://help.treble.ai/en/docs/data-warehouse-v2/fact-agent-status-changes.md): The availability history of every agent. - [fact_agent_daily](https://help.treble.ai/en/docs/data-warehouse-v2/fact-agent-daily.md): Pre-aggregated daily productivity metrics per agent. #### Conversions & Attribution - [fact_target_events](https://help.treble.ai/en/docs/data-warehouse-v2/fact-target-events.md): Conversion and goal events fired inside conversation flows. - [fact_ad_sessions](https://help.treble.ai/en/docs/data-warehouse-v2/fact-ad-sessions.md): Conversations that started from a Click-to-WhatsApp ad, with the ad's creative details. - [fact_whatsapp_link_events](https://help.treble.ai/en/docs/data-warehouse-v2/fact-whatsapp-link-events.md): Click and open events of your Treble WhatsApp links. ### Data Warehouse (Legacy) - [Data Warehouse (Legacy)](https://help.treble.ai/en/docs/data-warehouse/welcome.md): Query your data directly with SQL. Available for companies with access enabled. - [fact_conversations](https://help.treble.ai/en/docs/data-warehouse/fact-conversations.md): One row per conversation handled by an agent. - [fact_agent_messages](https://help.treble.ai/en/docs/data-warehouse/fact-agent-messages.md): One row per message in an agent conversation. - [fact_redirections](https://help.treble.ai/en/docs/data-warehouse/fact-redirections.md): One row per transfer between agents. - [fact_agent_status_changes](https://help.treble.ai/en/docs/data-warehouse/fact-agent-status-changes.md): One row per online/offline status change of an agent. - [fact_agent_daily](https://help.treble.ai/en/docs/data-warehouse/fact-agent-daily.md): Pre-aggregated productivity metrics per agent per day. - [fact_sessions](https://help.treble.ai/en/docs/data-warehouse/fact-sessions.md): One row per executed conversation flow. - [fact_deployment_status](https://help.treble.ai/en/docs/data-warehouse/fact-deployment-status.md): One row per outbound delivery (delivery attempt). - [fact_deployment_daily](https://help.treble.ai/en/docs/data-warehouse/fact-deployment-daily.md): Pre-aggregated delivery metrics per campaign per day. - [fact_hsm_responses](https://help.treble.ai/en/docs/data-warehouse/fact-hsm-responses.md): One row per user response to an HSM template. - [Dimension Tables](https://help.treble.ai/en/docs/data-warehouse/dimensions.md): Reference tables: agents, teams, tags, HSM templates. - [Query Optimization](https://help.treble.ai/en/docs/data-warehouse/query-optimization.md): How to write efficient queries against the Data Warehouse.