__( 'Attentive', 'advanced-form-integration' ), 'tasks' => array( 'create_subscriber' => __( 'Subscribe User', 'advanced-form-integration' ), ), ); return $actions; } add_filter( 'adfoin_settings_tabs', 'adfoin_attentive_settings_tab', 10, 1 ); function adfoin_attentive_settings_tab( $providers ) { $providers['attentive'] = __( 'Attentive', 'advanced-form-integration' ); return $providers; } add_action( 'adfoin_settings_view', 'adfoin_attentive_settings_view', 10, 1 ); function adfoin_attentive_settings_view( $current_tab ) { if ( 'attentive' !== $current_tab ) { return; } $title = __( 'Attentive', 'advanced-form-integration' ); $key = 'attentive'; $arguments = wp_json_encode( array( 'platform' => $key, 'fields' => array( array( 'key' => 'apiKey', 'label' => __( 'API Key', 'advanced-form-integration' ), 'hidden' => false, ), array( 'key' => 'baseUrl', 'label' => __( 'API Base URL (optional)', 'advanced-form-integration' ), 'hidden' => false, 'placeholder' => 'https://api.attentivemobile.com', ), ), ) ); $instructions = sprintf( '
%6$s
', esc_html__( 'Log in to Attentive and open the API Keys section of the Developer Portal.', 'advanced-form-integration' ), esc_html__( 'Generate a Server-to-Server API key and copy the value. Keep it secure.', 'advanced-form-integration' ), esc_html__( 'Paste the key here, optionally override the API base URL if Attentive provides a regional endpoint, and click "Save & Authenticate".', 'advanced-form-integration' ), esc_html__( 'In the Attentive platform, go to Sign-up Units tab and copy the Sign-up Source ID you want to use.', 'advanced-form-integration' ), esc_html__( 'Use the saved credential and Sign-up Source ID while configuring Attentive actions to subscribe users from your forms.', 'advanced-form-integration' ), esc_html__( 'AFI calls the Attentive Subscriptions API (v1/subscriptions) with your API key over HTTPS.', 'advanced-form-integration' ) ); echo adfoin_platform_settings_template( $title, $key, $arguments, $instructions ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } add_action( 'adfoin_action_fields', 'adfoin_attentive_action_fields' ); function adfoin_attentive_action_fields() { ?> 'phone', 'value' => __( 'Phone (E.164 format, e.g. +15555555555)', 'advanced-form-integration' ) ), array( 'key' => 'email', 'value' => __( 'Email', 'advanced-form-integration' ) ), array( 'key' => 'signUpSourceId', 'value' => __( 'Sign-up Source ID (required)', 'advanced-form-integration' ), 'required' => true, 'description' => __( 'Found in Sign-up Units tab of Attentive platform', 'advanced-form-integration' ) ), array( 'key' => 'clientUserId', 'value' => __( 'Client User ID (External Identifier)', 'advanced-form-integration' ) ), array( 'key' => 'shopifyId', 'value' => __( 'Shopify ID', 'advanced-form-integration' ) ), array( 'key' => 'klaviyoId', 'value' => __( 'Klaviyo ID', 'advanced-form-integration' ) ), array( 'key' => 'customIdentifiers', 'value' => __( 'Custom Identifiers (JSON array)', 'advanced-form-integration' ), 'type' => 'textarea', 'description' => __( 'Example: [{"name":"customKey","value":"customValue"}]', 'advanced-form-integration' ) ), array( 'key' => 'subscriptionType', 'value' => __( 'Subscription Type (MARKETING or TRANSACTIONAL)', 'advanced-form-integration' ), 'description' => __( 'Optional if signUpSourceId is provided', 'advanced-form-integration' ) ), array( 'key' => 'locale', 'value' => __( 'Locale (e.g. en-US)', 'advanced-form-integration' ), 'description' => __( 'Optional if signUpSourceId is provided', 'advanced-form-integration' ) ), array( 'key' => 'singleOptIn', 'value' => __( 'Single Opt-In (true/false)', 'advanced-form-integration' ), 'description' => __( 'Skips "Reply Y" message. Contact CSM before enabling.', 'advanced-form-integration' ) ), ); wp_send_json_success( $fields ); } add_action( 'adfoin_attentive_job_queue', 'adfoin_attentive_job_queue', 10, 1 ); function adfoin_attentive_job_queue( $data ) { adfoin_attentive_send_data( $data['record'], $data['posted_data'] ); } function adfoin_attentive_send_data( $record, $posted_data ) { $record_data = json_decode( $record['data'], true ); if ( adfoin_check_conditional_logic( $record_data['action_data']['cl'] ?? array(), $posted_data ) ) { return; } $field_data = isset( $record_data['field_data'] ) ? $record_data['field_data'] : array(); $cred_id = isset( $field_data['credId'] ) ? $field_data['credId'] : ''; if ( ! $cred_id ) { return; } $credentials = adfoin_attentive_get_credentials( $cred_id ); if ( is_wp_error( $credentials ) ) { adfoin_add_to_log( $credentials, '', array(), $record ); return; } $payload = adfoin_attentive_collect_payload( $field_data, $posted_data ); if ( is_wp_error( $payload ) ) { adfoin_add_to_log( $payload, '', array(), $record ); return; } if ( empty( $payload ) ) { return; } adfoin_attentive_request( 'subscriptions', 'POST', $payload, $record, $credentials ); } function adfoin_attentive_collect_payload( $field_data, $posted_data ) { $phone = adfoin_attentive_parse_value( $field_data, 'phone', $posted_data ); $email = adfoin_attentive_parse_value( $field_data, 'email', $posted_data ); if ( '' === $phone && '' === $email ) { return new WP_Error( 'attentive_missing_user', __( 'Attentive requires at least a phone number (E.164 format) or email address.', 'advanced-form-integration' ) ); } $sign_up_source_id = adfoin_attentive_parse_value( $field_data, 'signUpSourceId', $posted_data ); $locale = adfoin_attentive_parse_value( $field_data, 'locale', $posted_data ); $subscription_type = adfoin_attentive_parse_value( $field_data, 'subscriptionType', $posted_data ); if ( '' === $sign_up_source_id && ( '' === $locale || '' === $subscription_type ) ) { return new WP_Error( 'attentive_missing_required', __( 'Attentive requires either a Sign-up Source ID, or both Locale and Subscription Type.', 'advanced-form-integration' ) ); } $payload = array( 'user' => array(), ); if ( '' !== $phone ) { $payload['user']['phone'] = $phone; } if ( '' !== $email ) { $payload['user']['email'] = $email; } if ( '' !== $sign_up_source_id ) { $payload['signUpSourceId'] = $sign_up_source_id; } if ( '' !== $locale ) { $payload['locale'] = $locale; } if ( '' !== $subscription_type ) { $payload['subscriptionType'] = strtoupper( $subscription_type ); } $single_opt_in = adfoin_attentive_parse_value( $field_data, 'singleOptIn', $posted_data ); if ( '' !== $single_opt_in ) { $payload['singleOptIn'] = filter_var( $single_opt_in, FILTER_VALIDATE_BOOLEAN ); } $client_user_id = adfoin_attentive_parse_value( $field_data, 'clientUserId', $posted_data ); $shopify_id = adfoin_attentive_parse_value( $field_data, 'shopifyId', $posted_data ); $klaviyo_id = adfoin_attentive_parse_value( $field_data, 'klaviyoId', $posted_data ); $custom_ids = adfoin_attentive_parse_value( $field_data, 'customIdentifiers', $posted_data ); if ( '' !== $client_user_id || '' !== $shopify_id || '' !== $klaviyo_id || '' !== $custom_ids ) { $payload['externalIdentifiers'] = array(); if ( '' !== $client_user_id ) { $payload['externalIdentifiers']['clientUserId'] = $client_user_id; } if ( '' !== $shopify_id ) { $payload['externalIdentifiers']['shopifyId'] = $shopify_id; } if ( '' !== $klaviyo_id ) { $payload['externalIdentifiers']['klaviyoId'] = $klaviyo_id; } if ( '' !== $custom_ids ) { $decoded = json_decode( $custom_ids, true ); if ( JSON_ERROR_NONE !== json_last_error() || ! is_array( $decoded ) ) { return new WP_Error( 'attentive_invalid_custom_identifiers', __( 'Custom identifiers JSON is invalid.', 'advanced-form-integration' ) ); } $payload['externalIdentifiers']['customIdentifiers'] = $decoded; } } return $payload; } function adfoin_attentive_parse_value( $field_data, $key, $posted_data ) { if ( ! isset( $field_data[ $key ] ) ) { return ''; } $value = adfoin_get_parsed_values( $field_data[ $key ], $posted_data ); if ( is_array( $value ) ) { return ''; } return is_string( $value ) ? trim( $value ) : ''; } function adfoin_attentive_credentials_list() { $credentials = adfoin_read_credentials( 'attentive' ); foreach ( $credentials as $option ) { printf( '', esc_attr( $option['id'] ), esc_html( $option['title'] ) ); } } function adfoin_attentive_get_credentials( $cred_id ) { $credentials = adfoin_get_credentials_by_id( 'attentive', $cred_id ); if ( ! $credentials ) { return new WP_Error( 'attentive_missing_credentials', __( 'Attentive credentials not found.', 'advanced-form-integration' ) ); } return $credentials; } function adfoin_attentive_request( $endpoint, $method = 'POST', $data = array(), $record = array(), $credentials = array() ) { $api_key = isset( $credentials['apiKey'] ) ? trim( $credentials['apiKey'] ) : ''; $base = isset( $credentials['baseUrl'] ) && $credentials['baseUrl'] ? rtrim( $credentials['baseUrl'], '/' ) : 'https://api.attentivemobile.com'; if ( '' === $api_key ) { return new WP_Error( 'attentive_missing_api_key', __( 'Attentive API key is missing.', 'advanced-form-integration' ) ); } $url = $base . '/v1/' . ltrim( $endpoint, '/' ); $args = array( 'timeout' => 30, 'method' => strtoupper( $method ), 'headers' => array( 'Authorization' => 'Bearer ' . $api_key, 'Accept' => 'application/json', 'Content-Type' => 'application/json', ), ); if ( in_array( $args['method'], array( 'POST', 'PUT', 'PATCH' ), true ) ) { $args['body'] = wp_json_encode( $data ); } $response = wp_remote_request( esc_url_raw( $url ), $args ); if ( $record ) { adfoin_add_to_log( $response, $url, $args, $record ); } if ( is_wp_error( $response ) ) { return $response; } $status = wp_remote_retrieve_response_code( $response ); if ( $status >= 400 ) { $body = wp_remote_retrieve_body( $response ); $message = $body ? $body : __( 'Attentive request failed.', 'advanced-form-integration' ); return new WP_Error( 'attentive_http_error', $message, array( 'status' => $status ) ); } return $response; }