--- title: LiveHelpNow API Integration on Truto slug: livehelpnow category: Helpdesk canonical: "https://truto.one/integrations/detail/livehelpnow/" --- # LiveHelpNow API Integration on Truto **Category:** Helpdesk **Status:** Beta ## MCP-ready AI tools Truto exposes 64 tools for LiveHelpNow that AI agents can call directly. - **list_all_live_help_now_analytics_bot_funnels** — List LiveHelpNow chat bot funnel statistics for a date range. Returns: funnel, live_help_bot, path_hash, resulted_in_chat, times_taken. Required: date_from, date_to (both YYYY-MM-DD). - **list_all_live_help_now_analytics_chat_info** — List LiveHelpNow chat info records for a date range. Returns each chat with chat_session_id, accepted_time, start_time, end_time, chat_tags, operator_email, and visitor_id. Required: date_from, date_to (both YYYY-MM-DD). - **list_all_live_help_now_analytics_chat_stats_by_hour** — List LiveHelpNow hourly chat statistics — handled chats, dropped chats and offline requests broken down by hour of the day, one entry per department. Returns: chats_by_hour, dropped_chats_by_hour, offline_requests_by_hour. Required: date_from, date_to. - **get_single_live_help_now_analytics_chat_survey_detail_by_id** — Get LiveHelpNow chat survey details for a specific survey by id. Returns the survey's question-and-answer pairs: label (the survey question) and answer (the survey answer). Required: id. - **list_all_live_help_now_analytics_chat_surveys** — List LiveHelpNow chat survey submissions for a given date range. Returns: chat_session_detail_id, notes, submit_date, survey_id, survey_submission_id, visitor_id. Required: date_from, date_to (both in YYYY-MM-DD format). - **list_all_live_help_now_analytics_contact_list** — List LiveHelpNow chat contact list data for a given date range. Returns: AgentEmail, ChatID, ChatInitiatedBy, ChatLaunchedAt, ChatTime, Country, Custom1, Custom2, Custom3, Department, Detail1, Detail2, Detail3, Detail4, HostName, IPAddress, SurveyComment, SurveyName, SurveyQuestion1, and 9 more. Required: date_from, date_to (YYYY-MM-DD format). - **list_all_live_help_now_analytics_contact_nav_list** — List LiveHelpNow chat contact navigation data showing which pages each contact visited. Returns: AgentEmail, ChatID, Detail1, Detail2, Detail3, Detail4, Page, VisitTime, VisitorID. Required: date_from, date_to (YYYY-MM-DD format). - **list_all_live_help_now_analytics_daily_account_chat_statistics** — List daily account-level chat statistics in LiveHelpNow for a date range. Returns: abandoned_chats, auto_invitations_accepted, auto_invitations_shown, average_greet_time, average_wait_time, avg_session_chat_time, chat_sessions, chat_time, chats_handled, date, name, and 12 more. Required: date_from, date_to (both in YYYY-MM-DD format). - **list_all_live_help_now_analytics_daily_chatters** — List daily chatters data for the LiveHelpNow account, one record per chat visitor for the given day. Returns each chatter's @VisitorID, ChatTime, Country, DepartmentName, HostName, Referrer, visitor custom info, and pre-chat fields. Required: date_from, date_to (YYYY-MM-DD). - **list_all_analytics_daily_department_chat_statistics** — List LiveHelpNow daily department chat statistics between date_from and date_to (YYYY-MM-DD format), with one record per department per day. Returns: abandoned_chats, auto_invitations_accepted, avg_chat_time, avg_greet_time, avg_wait_time, chat_sessions, date, department_id, department_name, and 13 more. Required: date_from, date_to. - **list_all_live_help_now_analytics_operator_activity** — List a LiveHelpNow operator's online and offline activity for a date range. Returns activity entries with action and date. Required: operator_id, date_from, date_to (YYYY-MM-DD format). - **list_all_live_help_now_analytics_operator_stats** — List daily operator statistics for a LiveHelpNow operator. Returns: date, avg_chat_time_sec, avg_customer_wait_time_sec, avg_response_time_sec, chat_tranfers, chats_missed, proactive_chat_requests, total_chats, total_online_time, utilized_on_chat, and 2 more. Required: operator_id, date_from, date_to (both YYYY-MM-DD). - **list_all_live_help_now_analytics_operators_activity** — List online and offline activity for LiveHelpNow operators over a date range. Returns each operator's activity entries (action, timestamp), departments, and name, keyed by operator id. Required: date_from, date_to in YYYY-MM-DD format. - **list_all_live_help_now_analytics_operators_stats** — List daily operator statistics in LiveHelpNow over a date range. Returns an object keyed by operator_id, each entry containing the operator's name and a daily stats array with avg_chat_time_sec, total_chats, total_online_time and utilization. Required: date_from, date_to (YYYY-MM-DD). - **get_single_live_help_now_analytics_ticket_survey_detail_by_id** — Get the details of a ticket survey in LiveHelpNow by id. Returns the survey questions and answers: label, answer. Required: id. - **list_all_live_help_now_analytics_ticket_surveys** — List ticket surveys in LiveHelpNow submitted within a given date range. Returns: comment_id, department_id, notes, submit_date, survey_id, survey_submission_id, ticket_id. Required: date_from, date_to (both YYYY-MM-DD). - **update_a_live_help_now_attachment_by_id** — Update a LiveHelpNow attachment's context assignment, tying the attachment to a chat or ticket. Returns: message, status. Required: id, system, context_id. - **live_help_now_attachments_upload_context** — Upload a file to LiveHelpNow and link it to a chat session. Returns the attachment payload: chatMessage, createdTime, fromName, messageId, messageSubType, messageType, operatorId. Required: system, chat_session_id, name, length, data. - **live_help_now_attachments_upload_system** — Upload a new file attachment for a LiveHelpNow system (chat, ticket, or callback); the attachment is not assigned to a context. Returns: attachment_id, url. Required: system, name, length, data. - **live_help_now_callbacks_accept** — Accept a pending LiveHelpNow callback on behalf of an operator. Returns: department_id, message. Required: callback_id, operator_id. - **live_help_now_callbacks_create_comment** — Add a comment to a LiveHelpNow callback. Returns: message, status. Required: callback_id, comment, comment_type (notes_added or closed), operator_id. - **live_help_now_callbacks_assign** — Assign a LiveHelpNow callback to an operator and department. Returns: department_id, message. Required: callback_id, operator_id, department_id. - **get_single_live_help_now_callback_by_id** — Get a LiveHelpNow callback by id. Returns the callback record with id, title, status, assigned_operator_name, department_name, created_time, actions, fields, notes, and tags. Required: id. - **live_help_now_callbacks_list_filter_options** — List the available filter options for LiveHelpNow callback filters. Returns the assigned_to filter field with its selectable options (name, value) and input type. - **live_help_now_callbacks_list_filters** — List LiveHelpNow callback filters for a given operator. Returns: filter_id, filter_name, is_current. Required: operator_id. - **live_help_now_callbacks_search** — Search LiveHelpNow callbacks using a generic search term. Returns: id, title, subtitle, status, assigned_operator, assigned_operator_name, country_code, created_by, created_time, department_name, fields, visitor_id. Required: search_term. - **list_all_live_help_now_callbacks** — List LiveHelpNow callbacks for your account. Returns: id, title, subtitle, status, assigned_operator, assigned_operator_name, country_code, created_by, created_time, department_name, fields, visitor_id. - **delete_a_live_help_now_callback_by_id** — Delete a LiveHelpNow callback by id. Returns the confirmation message and system status of the deletion. Required: id. - **live_help_now_callbacks_reassign** — Reassign a LiveHelpNow callback to an operator. Returns: department_id, message. Required: callback_id, operator_id, department_id. - **list_all_live_help_now_canned_response_sets** — List available canned response sets in LiveHelpNow. Returns: enabled, id, name, order, parent_id. - **list_all_live_help_now_canned_response_items** — List canned response items for a given canned set in LiveHelpNow. Returns: enabled, id, message, order, title. Required: canned_set_id. - **live_help_now_chats_accept** — Have an operator accept a chat in LiveHelpNow. Returns: message, status. Required: chat_id. - **create_a_live_help_now_chat** — Create a new chat session in LiveHelpNow. Returns the session-start response from LiveHelpNow as an opaque payload; the upstream documentation does not enumerate its fields. - **live_help_now_chats_list_history** — List previous messages for a LiveHelpNow chat session. Returns each message with messageId, message, createdBy, createdTime, messageType, messageSubType, and visitorId. Required: chat_id, limit, ending_message_id. - **live_help_now_chats_list_messages** — List messages for a LiveHelpNow chat session. Returns each message with messageId, message, createdBy, createdTime, and messageType. Required: chat_id. - **live_help_now_chats_create_message** — Post a new message into a LiveHelpNow chat session. Returns: chatMessage, createdTime, fromName, messageId, messageSubType, messageType, operatorId. Required: chat_id, message. - **live_help_now_chats_proactive_invite** — Send a visitor a proactive chat invitation in LiveHelpNow. Returns the sent invite details: chatMessage, createdTime, fromName, messageId, messageSubType, messageType, operatorId. Required: message, visitor_id. - **live_help_now_chats_reassign** — Reassign a LiveHelpNow chat to a different department or operator by chat id. Returns: message, status. Required: chat_id, department_id. - **live_help_now_chats_set_typing_status** — Set the typing status for the operator or visitor in a LiveHelpNow chat session by chat id. Returns the typing status payload and the system response status. Required: chat_id, status. - **live_help_now_chats_terminate** — Terminate a LiveHelpNow chat session by chat id. Returns: message, status. Required: chat_id. - **list_all_live_help_now_client_status** — Get the online status of your LiveHelpNow account. Returns: status. - **list_all_live_help_now_departments** — List departments for your LiveHelpNow account. Returns: department_id, department_name, department_description, department_email, operators, hours. - **get_single_live_help_now_department_by_id** — Get the online status for a specific LiveHelpNow department by id. Returns the department's current status, which will be online or offline. Required: id. - **live_help_now_tickets_accept** — Accept a LiveHelpNow ticket by id, claiming it for handling. Returns the accept data: department_id, message. Required: ticket_id. - **live_help_now_tickets_acknowledge** — Acknowledge a LiveHelpNow ticket by id. Returns: message, status. Required: ticket_id. - **live_help_now_tickets_assign** — Assign a LiveHelpNow ticket to a department, optionally to a specific operator. Returns: message, status. Required: ticket_id, department_id. - **delete_a_live_help_now_ticket_by_id** — Delete a LiveHelpNow ticket by id. Returns: message, status. Required: id. - **live_help_now_tickets_reassign** — Reassign a LiveHelpNow ticket to a different department, optionally to a specific operator. Returns: message, status. Required: ticket_id, department_id. - **live_help_now_tickets_resolve** — Resolve a LiveHelpNow ticket by providing the solution. Returns: message, status. Required: ticket_id, solution, comment_type (must be "resolved"). - **get_single_live_help_now_ticket_by_id** — Get a single LiveHelpNow ticket by id. Returns the full ticket record including id, title, status, priority, category, submitter name and email, tags, and created/updated times. Required: id. - **live_help_now_tickets_search** — Search LiveHelpNow tickets for your account using a generic search term. Returns tickets with id, title, status, priority, email, tags, and more. Required: search_term. - **live_help_now_tickets_tag** — Add or remove a tag on a LiveHelpNow ticket. Returns: message, status. Required: ticket_id, tag_id, action ("add" or "delete"). - **update_a_live_help_now_ticket_by_id** — Update a single field on a LiveHelpNow ticket. Returns: message, status. Required: id, field_id, value. - **list_all_live_help_now_tickets** — List tickets for a LiveHelpNow account. Returns: id, title, body, status, priority, category, source, email, name, country_code, created_time, updated_time, acknowledged, assigned_to, assigned_to_name, client_id, has_attachments, tags, visitor_id. Supports ordering by date_created, action_date, or id. - **live_help_now_tickets_create_comment** — Add a comment to a specified LiveHelpNow ticket. Returns: message, status. Required: ticket_id, comment. - **list_all_live_help_now_visitors** — List visitors for your LiveHelpNow account. Returns each visitor's id, full_name, email, browser, current_page, chat_state, and state. Required: filter_id, operator_id. - **get_single_live_help_now_visitor_by_id** — Get detailed information for a specific LiveHelpNow visitor by id. Returns: details, notes. Required: id. - **live_help_now_visitors_invite** — Invite a visitor to a chat in LiveHelpNow. Returns: message, status. Required: visitor_id. - **update_a_live_help_now_visitor_by_id** — Update a LiveHelpNow visitor's custom information by id. Returns: message, status. Required: id, visitor_id, custom_info_1, custom_info_2, custom_info_3. - **list_all_live_help_now_ticket_categories** — List the ticket categories configured in LiveHelpNow. Returns the complete category lookup records, each with its id and category_name. Takes no parameters. - **list_all_live_help_now_ticket_filter_options** — List ticket filter options in LiveHelpNow. Returns the filter option data keyed by filter name (e.g. acknowledged, title), each with its filter type and available options (name, value). - **list_all_live_help_now_ticket_filters** — List LiveHelpNow ticket filters. Returns each filter with its filter_id, filter_name, and is_current flag. - **list_all_live_help_now_ticket_priorities** — List ticket priorities in LiveHelpNow. Returns each priority with its id and priority_name (e.g. 6 / High). No required parameters. - **list_all_live_help_now_visitor_activity** — List visitor activity records in LiveHelpNow. Returns each record's id and an attributes object whose remaining fields are defined upstream; the field-level breakdown is not enumerated in the API docs. ## How it works 1. **Link your customer's LiveHelpNow account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach LiveHelpNow.** The Proxy API is a 1-to-1 mapping of the LiveHelpNow API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Enrich CRM records with chat and lead data** — CRM and sales enablement platforms can offer their users a native LiveHelpNow connection that automatically creates and enriches contact records from pre-chat surveys, chat transcripts, and visitor sessions — turning support conversations into qualified leads. - **Sync support tickets with engineering workflows** — Issue trackers and project management SaaS can bridge LiveHelpNow tickets with developer tasks, letting support agents escalate bugs and automatically closing the loop in LiveHelpNow when engineers resolve the issue. - **Power BI dashboards and workforce management** — Analytics, WFM, and HR platforms can pull granular operator activity, chat statistics, and department-level metrics to forecast staffing, calculate agent payroll, and surface utilization trends inside their own dashboards. - **Trigger proactive chat from behavioral signals** — E-commerce, product analytics, and personalization tools can use their own behavioral triggers (idle carts, high-intent pages) to fire proactive chat invites in LiveHelpNow, combining their data with LiveHelpNow's chat delivery. - **Embed conversational handoff for AI assistants** — AI chatbot and virtual agent vendors can hand off conversations into LiveHelpNow with full context, letting human agents pick up where the bot left off without the end customer leaving the chat. ## What you can build - **Two-way ticket sync** — Mirror LiveHelpNow tickets into your app, update custom fields, post comments, and resolve or reassign tickets bi-directionally using the ticket management endpoints. - **Chat-to-lead pipeline** — Automatically ingest chat surveys, visitor profiles, and contact lists to create leads in your CRM with the full chat transcript attached as an activity. - **Operator performance analytics** — Build dashboards that visualize operator activity, login/logout timestamps, chat handling stats, and daily or hourly chat volume per department. - **Proactive chat triggers** — Expose a workflow builder that lets your users fire LiveHelpNow proactive invites to specific visitors based on events happening in your product. - **Unified inbox messaging** — Create new chats, post messages, manage typing status, and terminate sessions from your own agent workspace by wrapping the chat and message APIs. - **Callback and ticket automation** — Automate callback acceptance, assignment, and comment creation, and route tickets based on category, priority, or custom filter options defined in LiveHelpNow. ## FAQs ### How does authentication to LiveHelpNow work through Truto? Truto handles the LiveHelpNow authentication flow and credential storage for you. Your end users connect their LiveHelpNow account once through Truto's connect flow, and Truto manages token refresh and secure storage so you never touch raw credentials. ### Can we both read and write ticket data? Yes. The integration supports listing and retrieving tickets, updating ticket fields, accepting, acknowledging, assigning, reassigning, resolving, tagging, deleting, and posting comments — enabling full bi-directional ticket workflows. ### What analytics data can we pull for reporting use cases? You can access daily and hourly chat statistics at the account and department level, operator activity and stats, bot funnels, chat info, chatter lists, chat surveys, ticket surveys, and contact lists — enough to power WFM, CSAT, and BI dashboards. ### Can we trigger proactive chats from external events? Yes. The proactive invite endpoint lets you push a chat prompt to a specific visitor in LiveHelpNow based on triggers from your own product, such as cart abandonment or time-on-page thresholds. ### How fresh is the data — is it polling or real-time? The LiveHelpNow integration is request-based, so your app pulls data on demand or on a polling schedule you define. Truto normalizes pagination and request handling so you can poll frequently without managing API quirks. ### Do you support ticket categories, priorities, and custom filters? Yes. There are dedicated endpoints to list ticket categories, priorities, ticket filters, and filter options, so you can respect each customer's LiveHelpNow configuration when building routing and views.