__('Freshdesk', 'advanced-form-integration'),
'tasks' => [
'create_ticket' => __('Create Ticket', 'advanced-form-integration'),
],
];
return $actions;
}
add_filter('adfoin_settings_tabs', 'adfoin_freshdesk_settings_tab', 10, 1);
function adfoin_freshdesk_settings_tab($providers)
{
$providers['freshdesk'] = __('Freshdesk', 'advanced-form-integration');
return $providers;
}
add_action('adfoin_settings_view', 'adfoin_freshdesk_settings_view', 10, 1);
function adfoin_freshdesk_settings_view($current_tab)
{
if ($current_tab != 'freshdesk') {
return;
}
$title = __('Freshdesk', 'advanced-form-integration');
$key = 'freshdesk';
$arguments = wp_json_encode([
'platform' => $key,
'fields' => [
[
'key' => 'apiKey',
'label' => __('API Key', 'advanced-form-integration'),
'hidden' => true
],
[
'key' => 'appDomain',
'label' => __('App Domain', 'advanced-form-integration'),
'hidden' => false
]
]
]);
$instructions = __('
To find the API Key and App Domain, follow these steps:
- Copy your account\'s full domain (e.g., https://afi1234.freshdesk.com).
- Open Profile Settings, click View API Key, and copy it.
', 'advanced-form-integration');
echo adfoin_platform_settings_template($title, $key, $arguments, $instructions);
}
add_action('wp_ajax_adfoin_get_freshdesk_credentials', 'adfoin_get_freshdesk_credentials', 10, 0);
function adfoin_get_freshdesk_credentials() {
adfoin_verify_nonce();
$all_credentials = adfoin_read_credentials('freshdesk');
wp_send_json_success($all_credentials);
}
add_action('wp_ajax_adfoin_save_freshdesk_credentials', 'adfoin_save_freshdesk_credentials', 10, 0);
function adfoin_save_freshdesk_credentials() {
adfoin_verify_nonce();
$platform = sanitize_text_field( wp_unslash( $_POST['platform'] ) );
if ('freshdesk' == $platform) {
$data = adfoin_array_map_recursive('sanitize_text_field', $_POST['data']);
adfoin_save_credentials($platform, $data);
}
wp_send_json_success();
}
function adfoin_freshdesk_credentials_list() {
$html = '';
$credentials = adfoin_read_credentials('freshdesk');
foreach ($credentials as $option) {
$html .= '';
}
echo $html;
}
add_action('adfoin_action_fields', 'adfoin_freshdesk_action_fields');
function adfoin_freshdesk_action_fields() {
?>
'ticket_subject', 'value' => 'Ticket Subject', 'description' => ''],
['key' => 'ticket_description', 'value' => 'Ticket Description', 'description' => ''],
['key' => 'ticket_type', 'value' => 'Type', 'description' => ''],
['key' => 'ticket_source', 'value' => 'Source ID', 'description' => 'Email: 1, Portal: 2, Phone: 3, Chat: 7, Feedback Widget: 9, Outbound Email: 10'],
['key' => 'ticket_status', 'value' => 'Status', 'description' => 'Open: 2, Pending: 3, Resolved: 4, Closed: 5'],
['key' => 'ticket_priority', 'value' => 'Priority', 'description' => 'Low: 1, Medium: 2, High: 3, Urgent: 4'],
['key' => 'ticket_group_id', 'value' => 'Group ID', 'description' => $groups],
// ['key' => 'ticket_agent_id', 'value' => 'Agent ID', 'description' => $agents],
['key' => 'ticket_product_id', 'value' => 'Product ID', 'description' => ''],
['key' => 'ticket_cc_emails', 'value' => 'CC Emails', 'description' => ''],
['key' => 'contact_name', 'value' => 'Contact Name', 'description' => ''],
['key' => 'contact_email', 'value' => 'Contact Email', 'description' => ''],
['key' => 'contact_phone', 'value' => 'Contact Phone', 'description' => ''],
['key' => 'contact_job_title', 'value' => 'Contact Job Title', 'description' => ''],
['key' => 'contact_mobile', 'value' => 'Contact Mobile', 'description' => ''],
['key' => 'contact_twitter_id', 'value' => 'Contact Twitter', 'description' => ''],
['key' => 'contact_unique_external_id', 'value' => 'Contact Unique External ID', 'description' => ''],
['key' => 'contact_language', 'value' => 'Contact Language', 'description' => ''],
['key' => 'contact_time_zone', 'value' => 'Contact Time Zone', 'description' => ''],
['key' => 'contact_description', 'value' => 'Contact Description', 'description' => ''],
['key' => 'contact_address', 'value' => 'Contact Address', 'description' => ''],
['key' => 'company_name', 'value' => 'Company Name', 'description' => ''],
['key' => 'company_description', 'value' => 'Company Description', 'description' => ''],
['key' => 'company_notes', 'value' => 'Company Notes', 'description' => ''],
['key' => 'company_domains', 'value' => 'Company Domains', 'description' => '']
];
wp_send_json_success($fields);
}
add_action('adfoin_freshdesk_job_queue', 'adfoin_freshdesk_job_queue', 10, 1);
// Was previously hooked on the literal action 'adfoin_job_queue' (wrong — the
// dispatch fires "adfoin_{$action_provider}_job_queue") AND read flat keys
// 'action_provider' / 'task' that the dispatch payload never contained
// (it sends 'record' + 'posted_data'). Result: every Freshdesk submission
// in async mode was silently dropped. Both bugs fixed here.
function adfoin_freshdesk_job_queue($data)
{
adfoin_freshdesk_send_data($data['record'], $data['posted_data']);
}
function adfoin_freshdesk_send_data($record, $posted_data) {
$record_data = json_decode($record['data'], true);
if (isset($record_data['action_data']['cl']) && adfoin_check_conditional_logic($record_data['action_data']['cl'], $posted_data)) return;
$data = $record_data['field_data'];
$cred_id = empty($data['credId']) ? '' : $data['credId'];
$company_id = '';
$contact_id = '';
$ticket_id = '';
$ticket_fields = array_filter([
'subject' => empty($data['ticket_subject']) ? '' : adfoin_get_parsed_values($data['ticket_subject'], $posted_data),
'description' => empty($data['ticket_description']) ? '' : adfoin_get_parsed_values($data['ticket_description'], $posted_data),
'type' => empty($data['ticket_type']) ? '' : adfoin_get_parsed_values($data['ticket_type'], $posted_data),
'source' => empty($data['ticket_source']) ? '' : intval( adfoin_get_parsed_values($data['ticket_source'], $posted_data) ),
'priority' => empty($data['ticket_priority']) ? 1 : intval( adfoin_get_parsed_values( $data['ticket_priority'], $posted_data) ),
'status' => empty($data['ticket_status']) ? 2 : intval( adfoin_get_parsed_values($data['ticket_status'], $posted_data) ),
'group_id' => empty($data['ticket_group_id']) ? '' : intval( adfoin_get_parsed_values($data['ticket_group_id'], $posted_data) ),
// 'agent_id' => empty($data['ticket_agent_id']) ? '' : adfoin_get_parsed_values($data['ticket_agent_id'], $posted_data),
'product_id' => empty($data['ticket_product_id']) ? '' : adfoin_get_parsed_values($data['ticket_product_id'], $posted_data),
'cc_emails' => empty($data['ticket_cc_emails']) ? '' : adfoin_get_parsed_values($data['ticket_cc_emails'], $posted_data),
]);
// Freshdesk expects cc_emails as an array, not a comma string.
if ( ! empty( $ticket_fields['cc_emails'] ) && ! is_array( $ticket_fields['cc_emails'] ) ) {
$ticket_fields['cc_emails'] = array_values( array_filter( array_map( 'trim', explode( ',', $ticket_fields['cc_emails'] ) ), 'strlen' ) );
}
$contact_fields = array_filter([
'name' => empty($data['contact_name']) ? '' : adfoin_get_parsed_values($data['contact_name'], $posted_data),
'email' => empty($data['contact_email']) ? '' : adfoin_get_parsed_values($data['contact_email'], $posted_data),
'phone' => empty($data['contact_phone']) ? '' : adfoin_get_parsed_values($data['contact_phone'], $posted_data),
'job_title' => empty($data['contact_job_title']) ? '' : adfoin_get_parsed_values($data['contact_job_title'], $posted_data),
'mobile' => empty($data['contact_mobile']) ? '' : adfoin_get_parsed_values($data['contact_mobile'], $posted_data),
'twitter_id' => empty($data['contact_twitter_id']) ? '' : adfoin_get_parsed_values($data['contact_twitter_id'], $posted_data),
'unique_external_id' => empty($data['contact_unique_external_id']) ? '' : adfoin_get_parsed_values($data['contact_unique_external_id'], $posted_data),
'language' => empty($data['contact_language']) ? '' : adfoin_get_parsed_values($data['contact_language'], $posted_data),
'time_zone' => empty($data['contact_time_zone']) ? '' : adfoin_get_parsed_values($data['contact_time_zone'], $posted_data),
'description' => empty($data['contact_description']) ? '' : adfoin_get_parsed_values($data['contact_description'], $posted_data),
'address' => empty($data['contact_address']) ? '' : adfoin_get_parsed_values($data['contact_address'], $posted_data),
]);
if( isset( $data['company_name'] ) && $data['company_name'] != '' ) {
$company_fields = array_filter([
'name' => empty($data['company_name']) ? '' : adfoin_get_parsed_values($data['company_name'], $posted_data),
'description' => empty($data['company_description']) ? '' : adfoin_get_parsed_values($data['company_description'], $posted_data),
'notes' => empty($data['company_notes']) ? '' : adfoin_get_parsed_values($data['company_notes'], $posted_data),
'domains' => empty($data['company_domains']) ? '' : explode(',', adfoin_get_parsed_values($data['company_domains'], $posted_data)),
]);
$company_id = adfoin_freshdesk_find_company($company_fields, $cred_id);
if (!$company_id) {
$company_id = adfoin_freshdesk_create_company($company_fields, $record, $cred_id);
} else {
adfoin_freshdesk_request('companies/' . $company_id, 'PUT', $company_fields, $record, $cred_id);
}
if($company_id) {
$contact_fields['company_id'] = $company_id;
}
}
$contact_id = adfoin_freshdesk_find_contact($contact_fields, $cred_id);
if (!$contact_id) {
$contact_id = adfoin_freshdesk_create_contact($contact_fields, $record, $cred_id);
} else {
$response = adfoin_freshdesk_request('contacts/' . $contact_id, 'PUT', $contact_fields, $record, $cred_id);
}
if ($contact_id) {
$ticket_fields['requester_id'] = $contact_id;
}
$response = adfoin_freshdesk_request('tickets', 'POST', $ticket_fields, $record, $cred_id);
return $response;
}
function adfoin_freshdesk_find_company($company_fields, $cred_id) {
$company_name = isset( $company_fields['name'] ) ? $company_fields['name'] : '';
if ( '' === $company_name ) {
return false;
}
$response = adfoin_freshdesk_request( 'companies/autocomplete?name=' . rawurlencode( $company_name ), 'GET', [], [], $cred_id );
if (is_wp_error($response)) {
return false;
}
$body = json_decode(wp_remote_retrieve_body($response), true);
if (empty($body) || empty($body['companies'])) {
return false;
}
return $body['companies'][0]['id'];
}
function adfoin_freshdesk_create_company($company_fields, $record, $cred_id) {
$response = adfoin_freshdesk_request('companies', 'POST', $company_fields, $record, $cred_id);
if (is_wp_error($response)) {
return false;
}
$body = json_decode(wp_remote_retrieve_body($response), true);
if (empty($body)) {
return false;
}
return $body['id'];
}
function adfoin_freshdesk_find_contact($contact_fields, $cred_id) {
$contact_email = isset( $contact_fields['email'] ) ? $contact_fields['email'] : '';
if ( '' === $contact_email ) {
return false;
}
$response = adfoin_freshdesk_request('contacts?email=' . rawurlencode( $contact_email ), 'GET', [], [], $cred_id);
if (is_wp_error($response)) {
return false;
}
$body = json_decode(wp_remote_retrieve_body($response), true);
if (empty($body)) {
return false;
}
return $body[0]['id'];
}
function adfoin_freshdesk_create_contact($contact_fields, $record, $cred_id) {
$response = adfoin_freshdesk_request('contacts', 'POST', $contact_fields, $record, $cred_id);
if (is_wp_error($response)) {
return false;
}
$body = json_decode(wp_remote_retrieve_body($response), true);
if (empty($body)) {
return false;
}
return $body['id'];
}
function adfoin_freshdesk_get_agents_list($cred_id) {
$response = adfoin_freshdesk_request('agents', 'GET', [], [], $cred_id);
if (is_wp_error($response)) {
return false;
}
$body = json_decode(wp_remote_retrieve_body($response), true);
if (empty($body)) {
return false;
}
$agents = [];
foreach ($body as $agent) {
$agents[] = $agent['contact']['name'] . ': ' . $agent['id'];
}
return implode(', ', $agents);
}
function adfoin_freshdesk_get_groups_list($cred_id) {
$response = adfoin_freshdesk_request('groups', 'GET', [], [], $cred_id);
if (is_wp_error($response)) {
return false;
}
$body = json_decode(wp_remote_retrieve_body($response), true);
if (empty($body)) {
return false;
}
$groups = [];
foreach ($body as $group) {
$groups[] = $group['name'] . ': ' . $group['id'];
}
return implode(', ', $groups);
}
/*
* Freshdesk API Request
*/
/*
* Normalize whatever the user pasted into the App Domain field down to just the
* scheme + host (https://acme.freshdesk.com). Freshdesk's admin URL often looks
* like https://acme.freshdesk.com/a/profiles/123/edit — pasting that made the
* plugin build .../a/profiles/123/edit/api/v2/contacts → 404. Accepts a full
* URL, a bare host, or just the subdomain, and always returns https://host with
* no trailing path/slash.
*/
function adfoin_freshdesk_normalize_domain( $raw ) {
$raw = trim( (string) $raw );
if ( '' === $raw ) {
return '';
}
// Ensure there's a scheme so wp_parse_url can find the host.
$parsable = ( false === strpos( $raw, '://' ) ) ? 'https://' . $raw : $raw;
$host = wp_parse_url( $parsable, PHP_URL_HOST );
if ( ! $host ) {
// Couldn't parse a host — strip any path/space and use the first token.
$host = preg_replace( '#[/\s].*$#', '', $raw );
}
// Bare subdomain (no dot) → expand to the freshdesk.com host.
if ( $host && false === strpos( $host, '.' ) ) {
$host .= '.freshdesk.com';
}
return $host ? 'https://' . $host : '';
}
function adfoin_freshdesk_request($endpoint, $method = 'GET', $data = [], $record = [], $cred_id = '') {
$credentials = adfoin_get_credentials_by_id('freshdesk', $cred_id);
$api_key = isset($credentials['apiKey']) ? $credentials['apiKey'] : '';
$app_domain = isset($credentials['appDomain']) ? $credentials['appDomain'] : '';
$app_domain = adfoin_freshdesk_normalize_domain( $app_domain );
$url = $app_domain . '/api/v2/' . $endpoint;
$args = [
'timeout' => 30,
'method' => $method,
'headers' => [
'Content-Type' => 'application/json',
'Authorization' => 'Basic ' . base64_encode($api_key . ':X')
],
];
if ('POST' == $method || 'PUT' == $method) {
$args['body'] = wp_json_encode($data);
}
$response = wp_remote_request($url, $args);
if ($record) {
adfoin_add_to_log($response, $url, $args, $record);
}
return $response;
}