[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M781G7Q6R64PD5H156CJRSCF":3,"skill-same:01M781G7Q6R64PD5H156CJRSCF":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":29,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M781G7Q6R64PD5H156CJRSCF","pm-freshchat",null,"Freshchat connector knowledge and safe action guide.","polymetrics-ai\u002Fcli","polymetrics-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F177650388?v=4","01M77Z920R1RTP5NXCP1V1HNMS","Polymetrics","01M77Z921DPWZC4DQSSZNWF82B",7,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-freshchat\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pm-freshchat\ndescription: Freshchat connector knowledge and safe action guide.\n---\n\n# pm-freshchat\n\n## Purpose\n\nReads Freshchat account, user, conversation, agent, group, channel, role, outbound, report, metrics, and business-hours data through the Freshchat v2 REST API; writes Freshchat users, conversations, agents, outbound messages, reports, and CSAT ratings.\n\n## Icon\n\n- id: pm-sample\n- asset: icons\u002Fpm-sample.svg\n- source: polymetrics\n- review_status: polymetrics\n- review_url: https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- agent_id\n- agents_availability_status\n- agents_groups\n- agents_is_deactivated\n- agents_sort_by\n- agents_sort_order\n- base_url (required)\n- business_hours_group_id\n- channels_locale\n- conversation_id\n- conversation_messages_from_time\n- groups_sort_by\n- groups_sort_order\n- metrics_aggregator\n- metrics_end\n- metrics_filter_by\n- metrics_group_by\n- metrics_interval\n- metrics_metric\n- metrics_start\n- metrics_summary\n- mode\n- outbound_request_id\n- report_id\n- report_status\n- user_id\n- users_created_from\n- users_created_to\n- users_email\n- users_first_name\n- users_last_name\n- users_phone_no\n- users_reference_id\n- users_updated_from\n- users_updated_to\n- api_key (secret) (required)\n\n## ETL Streams\n\n- account_configuration:\n  - primary key: account_id\n  - fields: account_domain(string), account_id(integer), app_id(string), bundle_id(integer), bundle_type(string), datacenter(string), organisation_domain(string), organisation_id(integer), plan_type(string)\n- agents:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), biography(string), created_time(string), email(string), first_name(string), groups(array), id(string), is_deactivated(boolean), is_deleted(boolean), last_name(string), role_id(string), social_profiles(array), updated_time(string)\n- agent_details:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), biography(string), created_time(string), email(string), first_name(string), groups(array), id(string), is_deactivated(boolean), is_deleted(boolean), last_name(string), role_id(string), social_profiles(array), updated_time(string)\n- agent_statuses:\n  - primary key: id\n  - fields: enabled(boolean), id(string), name(string), type(string)\n- users:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), created_time(string), email(string), first_name(string), id(string), last_name(string), phone(string), properties(array), reference_id(string), restore_id(string), updated_time(string)\n- user_details:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), created_time(string), email(string), first_name(string), id(string), last_name(string), phone(string), properties(array), reference_id(string), restore_id(string), updated_time(string)\n- user_conversations:\n  - primary key: id\n  - fields: app_id(string), assigned_agent_id(string), assigned_group_id(string), channel_id(string), created_time(string), id(string), messages(array), priority(string), properties(object), status(string), updated_time(string), user_id(string)\n- conversation_detail:\n  - primary key: id\n  - fields: app_id(string), assigned_agent_id(string), assigned_group_id(string), channel_id(string), created_time(string), id(string), messages(array), priority(string), properties(object), status(string), updated_time(string), user_id(string)\n- conversation_messages:\n  - primary key: id\n  - fields: actor_id(string), actor_type(string), app_id(string), conversation_id(string), created_time(string), id(string), message_parts(array), message_type(string), updated_time(string)\n- conversation_fields:\n  - primary key: name\n  - fields: choices(array), label(string), name(string), required(boolean), type(string)\n- groups:\n  - primary key: id\n  - fields: created_time(string), description(string), id(string), name(string), routing_type(string), updated_time(string)\n- channels:\n  - primary key: id\n  - cursor: updated_time\n  - fields: created_time(string), enabled(boolean), icon(object), id(string), locale(string), name(string), public(boolean), tags(array), updated_time(string), welcome_message(object)\n- roles:\n  - primary key: id\n  - fields: description(string), id(string), name(string), role(string)\n- outbound_messages:\n  - primary key: id\n  - fields: created_time(string), from(object), id(string), provider(string), request_id(string), status(string), template(object), to(object), updated_time(string)\n- report_status:\n  - primary key: id\n  - fields: id(string), interval(string), link(object), links(array), status(string)\n- historical_metrics:\n  - primary key: metric_type\n  - fields: aggregator(string), data(array), end(string), filters(object), interval(string), metric_type(string), metrics(array), start(string)\n- instant_metrics:\n  - primary key: metric_type\n  - fields: aggregator(string), data(array), end(string), filters(object), interval(string), metric_type(string), metrics(array), start(string)\n- business_hours_status:\n  - primary key: group_id\n  - fields: business_hours_id(string), group_id(string), timezone(string), within_business_hours(boolean)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- create_user:\n  - endpoint: POST \u002Fusers\n  - risk: creates a Freshchat user\u002Fcontact visible to agents\n- update_user:\n  - endpoint: PUT \u002Fusers\u002F{{ record.user_id }}\n  - required fields: user_id\n  - risk: updates an existing Freshchat user\u002Fcontact\n- delete_user:\n  - endpoint: DELETE \u002Fusers\u002F{{ record.user_id }}\n  - required fields: user_id\n  - risk: deletes a Freshchat user\u002Fcontact; destructive and idempotent for configured missing statuses\n- create_conversation:\n  - endpoint: POST \u002Fconversations\n  - risk: creates a Freshchat conversation\n- update_conversation:\n  - endpoint: PUT \u002Fconversations\u002F{{ record.conversation_id }}\n  - required fields: conversation_id\n  - risk: updates routing, status, or properties on an existing Freshchat conversation\n- send_conversation_message:\n  - endpoint: POST \u002Fconversations\u002F{{ record.conversation_id }}\u002Fmessages\n  - required fields: conversation_id\n  - risk: sends a message into an existing Freshchat conversation\n- create_agent:\n  - endpoint: POST \u002Fagents\n  - required fields: email\n  - risk: creates a Freshchat admin\u002Fagent account; requires typed destructive confirmation because this is an administrative user-management action\n- update_agent:\n  - endpoint: PUT \u002Fagents\u002F{{ record.agent_id }}\n  - required fields: agent_id\n  - risk: updates a Freshchat admin\u002Fagent account; requires typed destructive confirmation because this mutates administrative access metadata\n- update_agent_status:\n  - endpoint: PATCH \u002Fagents\u002F{{ record.agent_id }}\n  - required fields: agent_id, status\n  - risk: updates a Freshchat agent availability status; requires typed destructive confirmation for administrative agent-state mutation\n- delete_agent:\n  - endpoint: DELETE \u002Fagents\u002F{{ record.agent_id }}\n  - required fields: agent_id\n  - risk: deletes a Freshchat admin\u002Fagent account; destructive and idempotent for configured missing statuses\n- send_outbound_whatsapp_message:\n  - endpoint: POST \u002Foutbound-messages\u002Fwhatsapp\n  - risk: sends an outbound WhatsApp message through Freshchat\n- extract_report:\n  - endpoint: POST \u002Freports\u002Fraw\n  - required fields: start, end, event, format\n  - risk: requests generation of a Freshchat raw report extract\n- create_csat_rating:\n  - endpoint: POST \u002Fcsat\u002F{{ record.conversation_id }}\n  - required fields: conversation_id\n  - risk: creates a CSAT rating for a Freshchat conversation\n\n## Security\n\n- read risk: external Freshchat API reads of account metadata, users, conversations, messages, agents, groups, channels, roles, outbound messages, reports, metrics, and business-hours status\n- write risk: creates, updates, or deletes Freshchat users, conversations, agents, outbound messages, reports, and CSAT ratings\n- approval: reverse ETL writes require plan preview and approval token\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Command Surface\n\n- Read Freshchat data and safely plan Freshchat write actions without raw provider escape hatches.\n- Usage: pm freshchat \u003Caccount|agents|users|conversations|groups|channels|roles|outbound|reports|metrics|business-hours|csat|direct|binary> \u003Ccommand> [flags]\n- Source CLI: Freshchat API (Freshchat API docs ETag W\u002F\"26e4fd8b1fe01578eae1dbaff6b69224\")\n- Global flags:\n  - --credential (non-empty) (string): Credential profile name; never pass secret values as flags.: maps_to=config.credential\n  - --config (string_array): Connector config override as key=value; never pass secret values here.\n  - --json (boolean): Render machine-readable JSON output.\n  - --limit (integer): Maximum records to emit from stream-backed commands.\n  - --preview (boolean): Preview a reverse-ETL write without making a network mutation.\n  - --plan (string): Execute an approved reverse-ETL plan by id.\n  - --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.\n  - --confirm (string): Typed confirmation challenge for destructive\u002Fadmin reverse-ETL writes.\n- Freshchat account read commands\n  - account configuration - Read Freshchat account configuration. [intent=etl availability=implemented stream=account_configuration]\n- Freshchat agent read\u002Fwrite\u002Fadmin commands\n  - agents list - List Freshchat agents with optional documented filters. [intent=etl availability=implemented stream=agents]; flags: --is-deactivated, --groups (non-empty), --availability-status, --sort-order, --sort-by (non-empty)\n  - agents view - Read one Freshchat agent by configured agent id. [intent=etl availability=implemented stream=agent_details]; flags: --agent-id (non-empty)\n  - agents statuses - List Freshchat agent statuses. [intent=etl availability=implemented stream=agent_statuses]\n  - agents create - Plan creation of a Freshchat admin\u002Fagent account. [intent=reverse_etl availability=implemented write=create_agent]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Creates a Freshchat admin\u002Fagent account.; flags: --email (non-empty), --first-name (non-empty), --last-name (non-empty), --role-id (non-empty), --groups\n  - agents update - Plan update of a Freshchat admin\u002Fagent account. [intent=reverse_etl availability=implemented write=update_agent]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Updates a Freshchat admin\u002Fagent account.; flags: --agent-id (non-empty), --first-name (non-empty), --last-name (non-empty), --role-id (non-empty), --groups, --is-deactivated\n  - agents status update - Plan update of a Freshchat agent availability status. [intent=reverse_etl availability=implemented write=update_agent_status]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Updates a Freshchat agent availability status.; flags: --agent-id (non-empty), --status (non-empty)\n  - agents delete - Plan deletion of a Freshchat admin\u002Fagent account. [intent=reverse_etl availability=implemented write=delete_agent]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Deletes a Freshchat admin\u002Fagent account.; flags: --agent-id (non-empty)\n- Freshchat user read\u002Fwrite commands\n  - users list - List Freshchat users with documented search filters. [intent=etl availability=implemented stream=users]; notes: Freshchat requires at least one user search filter for successful live \u002Fusers responses; connector config and command metadata expose the documented filter set without a raw query escape hatch.; flags: --first-name (non-empty), --last-name (non-empty), --email (non-empty), --reference-id (non-empty), --phone-no (non-empty), --created-from (non-empty, format=date-time), --created-to (non-empty, format=date-time), --updated-from (non-empty, format=date-time), --updated-to (non-empty, format=date-time)\n  - users view - Read one Freshchat user by configured user id. [intent=etl availability=implemented stream=user_details]; flags: --user-id (non-empty)\n  - users conversations - List conversations for a Freshchat user. [intent=etl availability=implemented stream=user_conversations]; flags: --user-id (non-empty)\n  - users create - Plan creation of a Freshchat user\u002Fcontact. [intent=reverse_etl availability=implemented write=create_user]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Creates a Freshchat user\u002Fcontact visible to agents.; flags: --email (non-empty), --first-name (non-empty), --last-name (non-empty), --phone (non-empty), --reference-id (non-empty)\n  - users update - Plan update of a Freshchat user\u002Fcontact. [intent=reverse_etl availability=implemented write=update_user]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Updates an existing Freshchat user\u002Fcontact.; flags: --user-id (non-empty), --email (non-empty), --first-name (non-empty), --last-name (non-empty), --phone (non-empty), --reference-id (non-empty)\n  - users delete - Plan deletion of a Freshchat user\u002Fcontact. [intent=reverse_etl availability=implemented write=delete_user]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Deletes a Freshchat user\u002Fcontact.; flags: --user-id (non-empty)\n- Freshchat conversation read\u002Fwrite commands\n  - conversations view - Read one Freshchat conversation. [intent=etl availability=implemented stream=conversation_detail]; flags: --conversation-id (non-empty)\n  - conversations messages - List messages in a Freshchat conversation. [intent=etl availability=implemented stream=conversation_messages]; flags: --conversation-id (non-empty), --from-time (non-empty, format=date-time)\n  - conversations fields - List Freshchat conversation property fields. [intent=etl availability=implemented stream=conversation_fields]\n  - conversations create - Plan creation of a Freshchat conversation. [intent=reverse_etl availability=implemented write=create_conversation]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Creates a Freshchat conversation.; flags: --user-id (non-empty), --channel-id (non-empty)\n  - conversations update - Plan update of a Freshchat conversation. [intent=reverse_etl availability=implemented write=update_conversation]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Updates status, routing, priority, or properties on a Freshchat conversation.; flags: --conversation-id (non-empty), --status (non-empty), --assigned-agent-id (non-empty), --assigned-group-id (non-empty), --priority (non-empty)\n  - conversations message send - Plan sending a message into a Freshchat conversation. [intent=reverse_etl availability=implemented write=send_conversation_message]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Sends a visible message into an existing Freshchat conversation.; flags: --conversation-id (non-empty), --actor-type (non-empty), --actor-id (non-empty)\n- Freshchat group read commands\n  - groups list - List Freshchat groups. [intent=etl availability=implemented stream=groups]; flags: --sort-order, --sort-by (non-empty)\n- Freshchat channel read commands\n  - channels list - List Freshchat channels\u002Ftopics. [intent=etl availability=implemented stream=channels]; flags: --locale (non-empty)\n- Freshchat role read commands\n  - roles list - List Freshchat roles. [intent=etl availability=implemented stream=roles]\n- Freshchat outbound read\u002Fwrite commands\n  - outbound messages list - List Freshchat outbound messages. [intent=etl availability=implemented stream=outbound_messages]; flags: --request-id (non-empty)\n  - outbound whatsapp send - Plan sending an outbound WhatsApp message through Freshchat. [intent=reverse_etl availability=implemented write=send_outbound_whatsapp_message]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Sends an outbound WhatsApp message through Freshchat.; flags: --provider (non-empty)\n- Freshchat report read\u002Fwrite commands\n  - reports status - Read Freshchat raw report status. [intent=etl availability=implemented stream=report_status]; flags: --report-id (non-empty), --status (non-empty)\n  - reports extract - Plan generation of a Freshchat raw report extract. [intent=reverse_etl availability=implemented write=extract_report]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Requests generation of a Freshchat raw report extract.; flags: --start (non-empty, format=date-time), --end (non-empty, format=date-time), --event (non-empty), --format\n- Freshchat metrics read commands\n  - metrics historical - Read Freshchat historical metrics. [intent=etl availability=implemented stream=historical_metrics]; flags: --metric (non-empty), --start (non-empty, format=date-time), --end (non-empty, format=date-time), --group-by (non-empty), --filter-by (non-empty), --aggregator (non-empty), --interval (non-empty)\n  - metrics instant - Read Freshchat instant metrics. [intent=etl availability=implemented stream=instant_metrics]; flags: --metric (non-empty), --group-by (non-empty), --filter-by (non-empty), --summary (non-empty)\n- Freshchat business-hours read commands\n  - business-hours status - Check whether a Freshchat group is within business hours. [intent=etl availability=implemented stream=business_hours_status]; flags: --group-id (non-empty)\n- Freshchat CSAT write commands\n  - csat create - Plan creation of a Freshchat CSAT rating. [intent=reverse_etl availability=implemented write=create_csat_rating]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Creates a CSAT rating for a Freshchat conversation.; flags: --conversation-id (non-empty), --rating, --comment (non-empty)\n- Planned bounded provider-search commands\n  - direct users fetch - Planned bounded subset fetch for up to 100 Freshchat user ids. [intent=direct_read availability=planned]; approval: none until #2985 provides executable provider_search\u002Fprovider_query safety; no live call is available today.; risk: medium; notes: Blocked on #2985 typed provider-search\u002Fquery foundation. The official request body is ids[] with a provider-documented maximum of 100 users; no raw body escape hatch is exposed.; flags: --ids, --page, --page-cursor\n- Planned binary\u002Fmultipart commands\n  - binary files upload - Planned Freshchat file upload. [intent=direct_write availability=planned]; approval: blocked until a typed binary\u002Fmultipart plan -> preview -> approval -> execute contract exists.; risk: high; notes: Blocked binary\u002Ffile operation. Official API accepts one multipart file with a documented 25 MB cap; this connector currently accepts no filesystem path or binary payload.; flags: --file (non-empty)\n  - binary images upload - Planned Freshchat image upload. [intent=direct_write availability=planned]; approval: blocked until a typed binary\u002Fmultipart plan -> preview -> approval -> execute contract exists.; risk: high; notes: Blocked binary\u002Ffile operation. Official API accepts multipart image input; this connector currently accepts no filesystem path or binary payload.; flags: --image (non-empty)\n- Help topics:\n  - destructive-confirmation - Freshchat DELETE and admin\u002Fagent-management operations require typed destructive confirmation plus reverse ETL plan -> preview -> approval -> execute.\n  - provider-search - Freshchat POST \u002Fusers\u002Ffetch remains planned\u002Fblocked on #2985 and is not exposed as a raw query\u002Fbody command.\n  - binary-uploads - Freshchat file\u002Fimage uploads remain planned\u002Fblocked until a typed binary\u002Fmultipart safety contract exists.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect freshchat\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect freshchat --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect freshchat before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n","# pm-freshchat\n\n## Purpose\n\nReads Freshchat account, user, conversation, agent, group, channel, role, outbound, report, metrics, and business-hours data through the Freshchat v2 REST API; writes Freshchat users, conversations, agents, outbound messages, reports, and CSAT ratings.\n\n## Icon\n\n- id: pm-sample\n- asset: icons\u002Fpm-sample.svg\n- source: polymetrics\n- review_status: polymetrics\n- review_url: https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- agent_id\n- agents_availability_status\n- agents_groups\n- agents_is_deactivated\n- agents_sort_by\n- agents_sort_order\n- base_url (required)\n- business_hours_group_id\n- channels_locale\n- conversation_id\n- conversation_messages_from_time\n- groups_sort_by\n- groups_sort_order\n- metrics_aggregator\n- metrics_end\n- metrics_filter_by\n- metrics_group_by\n- metrics_interval\n- metrics_metric\n- metrics_start\n- metrics_summary\n- mode\n- outbound_request_id\n- report_id\n- report_status\n- user_id\n- users_created_from\n- users_created_to\n- users_email\n- users_first_name\n- users_last_name\n- users_phone_no\n- users_reference_id\n- users_updated_from\n- users_updated_to\n- api_key (secret) (required)\n\n## ETL Streams\n\n- account_configuration:\n  - primary key: account_id\n  - fields: account_domain(string), account_id(integer), app_id(string), bundle_id(integer), bundle_type(string), datacenter(string), organisation_domain(string), organisation_id(integer), plan_type(string)\n- agents:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), biography(string), created_time(string), email(string), first_name(string), groups(array), id(string), is_deactivated(boolean), is_deleted(boolean), last_name(string), role_id(string), social_profiles(array), updated_time(string)\n- agent_details:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), biography(string), created_time(string), email(string), first_name(string), groups(array), id(string), is_deactivated(boolean), is_deleted(boolean), last_name(string), role_id(string), social_profiles(array), updated_time(string)\n- agent_statuses:\n  - primary key: id\n  - fields: enabled(boolean), id(string), name(string), type(string)\n- users:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), created_time(string), email(string), first_name(string), id(string), last_name(string), phone(string), properties(array), reference_id(string), restore_id(string), updated_time(string)\n- user_details:\n  - primary key: id\n  - cursor: updated_time\n  - fields: avatar(object), created_time(string), email(string), first_name(string), id(string), last_name(string), phone(string), properties(array), reference_id(string), restore_id(string), updated_time(string)\n- user_conversations:\n  - primary key: id\n  - fields: app_id(string), assigned_agent_id(string), assigned_group_id(string), channel_id(string), created_time(string), id(string), messages(array), priority(string), properties(object), status(string), updated_time(string), user_id(string)\n- conversation_detail:\n  - primary key: id\n  - fields: app_id(string), assigned_agent_id(string), assigned_group_id(string), channel_id(string), created_time(string), id(string), messages(array), priority(string), properties(object), status(string), updated_time(string), user_id(string)\n- conversation_messages:\n  - primary key: id\n  - fields: actor_id(string), actor_type(string), app_id(string), conversation_id(string), created_time(string), id(string), message_parts(array), message_type(string), updated_time(string)\n- conversation_fields:\n  - primary key: name\n  - fields: choices(array), label(string), name(string), required(boolean), type(string)\n- groups:\n  - primary key: id\n  - fields: created_time(string), description(string), id(string), name(string), routing_type(string), updated_time(string)\n- channels:\n  - primary key: id\n  - cursor: updated_time\n  - fields: created_time(string), enabled(boolean), icon(object), id(string), locale(string), name(string), public(boolean), tags(array), updated_time(string), welcome_message(object)\n- roles:\n  - primary key: id\n  - fields: description(string), id(string), name(string), role(string)\n- outbound_messages:\n  - primary key: id\n  - fields: created_time(string), from(object), id(string), provider(string), request_id(string), status(string), template(object), to(object), updated_time(string)\n- report_status:\n  - primary key: id\n  - fields: id(string), interval(string), link(object), links(array), status(string)\n- historical_metrics:\n  - primary key: metric_type\n  - fields: aggregator(string), data(array), end(string), filters(object), interval(string), metric_type(string), metrics(array), start(string)\n- instant_metrics:\n  - primary key: metric_type\n  - fields: aggregator(string), data(array), end(string), filters(object), interval(string), metric_type(string), metrics(array), start(string)\n- business_hours_status:\n  - primary key: group_id\n  - fields: business_hours_id(string), group_id(string), timezone(string), within_business_hours(boolean)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- create_user:\n  - endpoint: POST \u002Fusers\n  - risk: creates a Freshchat user\u002Fcontact visible to agents\n- update_user:\n  - endpoint: PUT \u002Fusers\u002F{{ record.user_id }}\n  - required fields: user_id\n  - risk: updates an existing Freshchat user\u002Fcontact\n- delete_user:\n  - endpoint: DELETE \u002Fusers\u002F{{ record.user_id }}\n  - required fields: user_id\n  - risk: deletes a Freshchat user\u002Fcontact; destructive and idempotent for configured missing statuses\n- create_conversation:\n  - endpoint: POST \u002Fconversations\n  - risk: creates a Freshchat conversation\n- update_conversation:\n  - endpoint: PUT \u002Fconversations\u002F{{ record.conversation_id }}\n  - required fields: conversation_id\n  - risk: updates routing, status, or properties on an existing Freshchat conversation\n- send_conversation_message:\n  - endpoint: POST \u002Fconversations\u002F{{ record.conversation_id }}\u002Fmessages\n  - required fields: conversation_id\n  - risk: sends a message into an existing Freshchat conversation\n- create_agent:\n  - endpoint: POST \u002Fagents\n  - required fields: email\n  - risk: creates a Freshchat admin\u002Fagent account; requires typed destructive confirmation because this is an administrative user-management action\n- update_agent:\n  - endpoint: PUT \u002Fagents\u002F{{ record.agent_id }}\n  - required fields: agent_id\n  - risk: updates a Freshchat admin\u002Fagent account; requires typed destructive confirmation because this mutates administrative access metadata\n- update_agent_status:\n  - endpoint: PATCH \u002Fagents\u002F{{ record.agent_id }}\n  - required fields: agent_id, status\n  - risk: updates a Freshchat agent availability status; requires typed destructive confirmation for administrative agent-state mutation\n- delete_agent:\n  - endpoint: DELETE \u002Fagents\u002F{{ record.agent_id }}\n  - required fields: agent_id\n  - risk: deletes a Freshchat admin\u002Fagent account; destructive and idempotent for configured missing statuses\n- send_outbound_whatsapp_message:\n  - endpoint: POST \u002Foutbound-messages\u002Fwhatsapp\n  - risk: sends an outbound WhatsApp message through Freshchat\n- extract_report:\n  - endpoint: POST \u002Freports\u002Fraw\n  - required fields: start, end, event, format\n  - risk: requests generation of a Freshchat raw report extract\n- create_csat_rating:\n  - endpoint: POST \u002Fcsat\u002F{{ record.conversation_id }}\n  - required fields: conversation_id\n  - risk: creates a CSAT rating for a Freshchat conversation\n\n## Security\n\n- read risk: external Freshchat API reads of account metadata, users, conversations, messages, agents, groups, channels, roles, outbound messages, reports, metrics, and business-hours status\n- write risk: creates, updates, or deletes Freshchat users, conversations, agents, outbound messages, reports, and CSAT ratings\n- approval: reverse ETL writes require plan preview and approval token\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Command Surface\n\n- Read Freshchat data and safely plan Freshchat write actions without raw provider escape hatches.\n- Usage: pm freshchat \u003Caccount|agents|users|conversations|groups|channels|roles|outbound|reports|metrics|business-hours|csat|direct|binary> \u003Ccommand> [flags]\n- Source CLI: Freshchat API (Freshchat API docs ETag W\u002F\"26e4fd8b1fe01578eae1dbaff6b69224\")\n- Global flags:\n  - --credential (non-empty) (string): Credential profile name; never pass secret values as flags.: maps_to=config.credential\n  - --config (string_array): Connector config override as key=value; never pass secret values here.\n  - --json (boolean): Render machine-readable JSON output.\n  - --limit (integer): Maximum records to emit from stream-backed commands.\n  - --preview (boolean): Preview a reverse-ETL write without making a network mutation.\n  - --plan (string): Execute an approved reverse-ETL plan by id.\n  - --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.\n  - --confirm (string): Typed confirmation challenge for destructive\u002Fadmin reverse-ETL writes.\n- Freshchat account read commands\n  - account configuration - Read Freshchat account configuration. [intent=etl availability=implemented stream=account_configuration]\n- Freshchat agent read\u002Fwrite\u002Fadmin commands\n  - agents list - List Freshchat agents with optional documented filters. [intent=etl availability=implemented stream=agents]; flags: --is-deactivated, --groups (non-empty), --availability-status, --sort-order, --sort-by (non-empty)\n  - agents view - Read one Freshchat agent by configured agent id. [intent=etl availability=implemented stream=agent_details]; flags: --agent-id (non-empty)\n  - agents statuses - List Freshchat agent statuses. [intent=etl availability=implemented stream=agent_statuses]\n  - agents create - Plan creation of a Freshchat admin\u002Fagent account. [intent=reverse_etl availability=implemented write=create_agent]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Creates a Freshchat admin\u002Fagent account.; flags: --email (non-empty), --first-name (non-empty), --last-name (non-empty), --role-id (non-empty), --groups\n  - agents update - Plan update of a Freshchat admin\u002Fagent account. [intent=reverse_etl availability=implemented write=update_agent]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Updates a Freshchat admin\u002Fagent account.; flags: --agent-id (non-empty), --first-name (non-empty), --last-name (non-empty), --role-id (non-empty), --groups, --is-deactivated\n  - agents status update - Plan update of a Freshchat agent availability status. [intent=reverse_etl availability=implemented write=update_agent_status]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Updates a Freshchat agent availability status.; flags: --agent-id (non-empty), --status (non-empty)\n  - agents delete - Plan deletion of a Freshchat admin\u002Fagent account. [intent=reverse_etl availability=implemented write=delete_agent]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Deletes a Freshchat admin\u002Fagent account.; flags: --agent-id (non-empty)\n- Freshchat user read\u002Fwrite commands\n  - users list - List Freshchat users with documented search filters. [intent=etl availability=implemented stream=users]; notes: Freshchat requires at least one user search filter for successful live \u002Fusers responses; connector config and command metadata expose the documented filter set without a raw query escape hatch.; flags: --first-name (non-empty), --last-name (non-empty), --email (non-empty), --reference-id (non-empty), --phone-no (non-empty), --created-from (non-empty, format=date-time), --created-to (non-empty, format=date-time), --updated-from (non-empty, format=date-time), --updated-to (non-empty, format=date-time)\n  - users view - Read one Freshchat user by configured user id. [intent=etl availability=implemented stream=user_details]; flags: --user-id (non-empty)\n  - users conversations - List conversations for a Freshchat user. [intent=etl availability=implemented stream=user_conversations]; flags: --user-id (non-empty)\n  - users create - Plan creation of a Freshchat user\u002Fcontact. [intent=reverse_etl availability=implemented write=create_user]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Creates a Freshchat user\u002Fcontact visible to agents.; flags: --email (non-empty), --first-name (non-empty), --last-name (non-empty), --phone (non-empty), --reference-id (non-empty)\n  - users update - Plan update of a Freshchat user\u002Fcontact. [intent=reverse_etl availability=implemented write=update_user]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Updates an existing Freshchat user\u002Fcontact.; flags: --user-id (non-empty), --email (non-empty), --first-name (non-empty), --last-name (non-empty), --phone (non-empty), --reference-id (non-empty)\n  - users delete - Plan deletion of a Freshchat user\u002Fcontact. [intent=reverse_etl availability=implemented write=delete_user]; approval: Destructive\u002Fadmin reverse ETL writes require typed destructive confirmation plus plan -> preview -> explicit approval -> execute.; risk: Deletes a Freshchat user\u002Fcontact.; flags: --user-id (non-empty)\n- Freshchat conversation read\u002Fwrite commands\n  - conversations view - Read one Freshchat conversation. [intent=etl availability=implemented stream=conversation_detail]; flags: --conversation-id (non-empty)\n  - conversations messages - List messages in a Freshchat conversation. [intent=etl availability=implemented stream=conversation_messages]; flags: --conversation-id (non-empty), --from-time (non-empty, format=date-time)\n  - conversations fields - List Freshchat conversation property fields. [intent=etl availability=implemented stream=conversation_fields]\n  - conversations create - Plan creation of a Freshchat conversation. [intent=reverse_etl availability=implemented write=create_conversation]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Creates a Freshchat conversation.; flags: --user-id (non-empty), --channel-id (non-empty)\n  - conversations update - Plan update of a Freshchat conversation. [intent=reverse_etl availability=implemented write=update_conversation]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Updates status, routing, priority, or properties on a Freshchat conversation.; flags: --conversation-id (non-empty), --status (non-empty), --assigned-agent-id (non-empty), --assigned-group-id (non-empty), --priority (non-empty)\n  - conversations message send - Plan sending a message into a Freshchat conversation. [intent=reverse_etl availability=implemented write=send_conversation_message]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Sends a visible message into an existing Freshchat conversation.; flags: --conversation-id (non-empty), --actor-type (non-empty), --actor-id (non-empty)\n- Freshchat group read commands\n  - groups list - List Freshchat groups. [intent=etl availability=implemented stream=groups]; flags: --sort-order, --sort-by (non-empty)\n- Freshchat channel read commands\n  - channels list - List Freshchat channels\u002Ftopics. [intent=etl availability=implemented stream=channels]; flags: --locale (non-empty)\n- Freshchat role read commands\n  - roles list - List Freshchat roles. [intent=etl availability=implemented stream=roles]\n- Freshchat outbound read\u002Fwrite commands\n  - outbound messages list - List Freshchat outbound messages. [intent=etl availability=implemented stream=outbound_messages]; flags: --request-id (non-empty)\n  - outbound whatsapp send - Plan sending an outbound WhatsApp message through Freshchat. [intent=reverse_etl availability=implemented write=send_outbound_whatsapp_message]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Sends an outbound WhatsApp message through Freshchat.; flags: --provider (non-empty)\n- Freshchat report read\u002Fwrite commands\n  - reports status - Read Freshchat raw report status. [intent=etl availability=implemented stream=report_status]; flags: --report-id (non-empty), --status (non-empty)\n  - reports extract - Plan generation of a Freshchat raw report extract. [intent=reverse_etl availability=implemented write=extract_report]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Requests generation of a Freshchat raw report extract.; flags: --start (non-empty, format=date-time), --end (non-empty, format=date-time), --event (non-empty), --format\n- Freshchat metrics read commands\n  - metrics historical - Read Freshchat historical metrics. [intent=etl availability=implemented stream=historical_metrics]; flags: --metric (non-empty), --start (non-empty, format=date-time), --end (non-empty, format=date-time), --group-by (non-empty), --filter-by (non-empty), --aggregator (non-empty), --interval (non-empty)\n  - metrics instant - Read Freshchat instant metrics. [intent=etl availability=implemented stream=instant_metrics]; flags: --metric (non-empty), --group-by (non-empty), --filter-by (non-empty), --summary (non-empty)\n- Freshchat business-hours read commands\n  - business-hours status - Check whether a Freshchat group is within business hours. [intent=etl availability=implemented stream=business_hours_status]; flags: --group-id (non-empty)\n- Freshchat CSAT write commands\n  - csat create - Plan creation of a Freshchat CSAT rating. [intent=reverse_etl availability=implemented write=create_csat_rating]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute.; risk: Creates a CSAT rating for a Freshchat conversation.; flags: --conversation-id (non-empty), --rating, --comment (non-empty)\n- Planned bounded provider-search commands\n  - direct users fetch - Planned bounded subset fetch for up to 100 Freshchat user ids. [intent=direct_read availability=planned]; approval: none until #2985 provides executable provider_search\u002Fprovider_query safety; no live call is available today.; risk: medium; notes: Blocked on #2985 typed provider-search\u002Fquery foundation. The official request body is ids[] with a provider-documented maximum of 100 users; no raw body escape hatch is exposed.; flags: --ids, --page, --page-cursor\n- Planned binary\u002Fmultipart commands\n  - binary files upload - Planned Freshchat file upload. [intent=direct_write availability=planned]; approval: blocked until a typed binary\u002Fmultipart plan -> preview -> approval -> execute contract exists.; risk: high; notes: Blocked binary\u002Ffile operation. Official API accepts one multipart file with a documented 25 MB cap; this connector currently accepts no filesystem path or binary payload.; flags: --file (non-empty)\n  - binary images upload - Planned Freshchat image upload. [intent=direct_write availability=planned]; approval: blocked until a typed binary\u002Fmultipart plan -> preview -> approval -> execute contract exists.; risk: high; notes: Blocked binary\u002Ffile operation. Official API accepts multipart image input; this connector currently accepts no filesystem path or binary payload.; flags: --image (non-empty)\n- Help topics:\n  - destructive-confirmation - Freshchat DELETE and admin\u002Fagent-management operations require typed destructive confirmation plus reverse ETL plan -> preview -> approval -> execute.\n  - provider-search - Freshchat POST \u002Fusers\u002Ffetch remains planned\u002Fblocked on #2985 and is not exposed as a raw query\u002Fbody command.\n  - binary-uploads - Freshchat file\u002Fimage uploads remain planned\u002Fblocked until a typed binary\u002Fmultipart safety contract exists.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect freshchat\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect freshchat --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect freshchat before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n",{"name":5,"description":7},"main","813f457a925f7ee3fe3bea101a43e445992c8552","docs\u002Fskills\u002Fpm-freshchat",0,"https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli","https:\u002F\u002Fcli.polymetrics.ai","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai","Local-first data infrastructure for agents and developers.","2026-09-21 12:42:03",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add polymetrics-ai\u002Fcli --skill pm-freshchat",{"tool":39,"command":40},"bunx","bunx skills add polymetrics-ai\u002Fcli --skill pm-freshchat",{"tool":42,"command":43},"pnpm","pnpm dlx skills add polymetrics-ai\u002Fcli --skill pm-freshchat","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-freshchat\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M782EH9BFHYZVECKJ31F427S","recipe-preview-approve-reverse-etl","Preview and approve a reverse ETL plan safely.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-preview-approve-reverse-etl\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M782EFGH5NRZ2CXDK0V9YWFW","recipe-github-prs-to-warehouse","Sync GitHub pull requests into the local warehouse.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-github-prs-to-warehouse\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M782ECJZRQAK8E86CE7R2YM2","pm-zoom","Zoom connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoom\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M782EASYDANMV35W2ZHG2QD0","pm-zonka-feedback","Zonka Feedback connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zonka-feedback\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M782E8WA94A906385AET1ZWH","pm-zoho-invoice","Zoho Invoice connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-invoice\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M782E73M7F23B6VBGM72QMMQ","pm-zoho-inventory","Zoho Inventory connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-inventory\u002FSKILL.md",[],[]]