'Housecall Pro',
'tasks' => array(
'create_customer' => 'Create Customer',
'create_lead' => 'Create Lead',
)
);
return $actions;
}
add_filter( 'adfoin_settings_tabs', 'adfoin_housecallpro_settings_tab', 10, 1 );
function adfoin_housecallpro_settings_tab( $providers ) {
$providers['housecallpro'] = 'Housecall Pro';
return $providers;
}
add_action( 'adfoin_settings_view', 'adfoin_housecallpro_settings_view', 10, 1 );
function adfoin_housecallpro_settings_view( $current_tab ) {
if ( $current_tab !== 'housecallpro' ) return;
$arguments = wp_json_encode( array(
'platform' => 'housecallpro',
'fields' => array(
array( 'key' => 'apiKey', 'label' => __( 'API Key', 'advanced-form-integration' ), 'hidden' => true ),
),
) );
$instructions = __( 'In Housecall Pro, go to Settings > Integrations > API. Generate an API key and paste it above.', 'advanced-form-integration' );
echo adfoin_platform_settings_template( __( 'Housecall Pro', 'advanced-form-integration' ), 'housecallpro', $arguments, $instructions );
}
add_action( 'adfoin_action_fields', 'adfoin_housecallpro_action_fields' );
function adfoin_housecallpro_action_fields() {
?>
'firstName', 'value' => 'First Name', 'description' => '' ),
array( 'key' => 'lastName', 'value' => 'Last Name', 'description' => '' ),
array( 'key' => 'email', 'value' => 'Email', 'description' => '' ),
array( 'key' => 'phone', 'value' => 'Phone', 'description' => '' ),
array( 'key' => 'mobile', 'value' => 'Mobile', 'description' => '' ),
array( 'key' => 'company', 'value' => 'Company', 'description' => '' ),
array( 'key' => 'address', 'value' => 'Street', 'description' => '' ),
array( 'key' => 'address2', 'value' => 'Street 2', 'description' => '' ),
array( 'key' => 'city', 'value' => 'City', 'description' => '' ),
array( 'key' => 'state', 'value' => 'State', 'description' => '' ),
array( 'key' => 'zip', 'value' => 'Zip', 'description' => '' ),
array( 'key' => 'country', 'value' => 'Country', 'description' => '' ),
array( 'key' => 'leadSource','value' => 'Lead Source','description' => '' ),
array( 'key' => 'note', 'value' => 'Note', 'description' => '' ),
);
wp_send_json_success( $fields );
}
function adfoin_housecallpro_credentials_list() {
foreach ( adfoin_read_credentials( 'housecallpro' ) as $option ) {
printf( '', esc_attr( $option['id'] ), esc_html( $option['title'] ) );
}
}
function adfoin_housecallpro_request( $endpoint, $method = 'POST', $data = array(), $record = array(), $cred_id = '' ) {
$credentials = adfoin_get_credentials_by_id( 'housecallpro', $cred_id );
$api_key = isset( $credentials['apiKey'] ) ? $credentials['apiKey'] : '';
if ( ! $api_key ) return;
$url = 'https://api.housecallpro.com/' . ltrim( $endpoint, '/' );
$args = array(
'timeout' => 30,
'method' => $method,
'headers' => array(
'Authorization' => 'Token ' . $api_key,
'Content-Type' => 'application/json',
'Accept' => 'application/json',
),
);
if ( $method === 'POST' || $method === 'PUT' ) $args['body'] = wp_json_encode( $data );
$response = wp_remote_request( $url, $args );
if ( $record ) adfoin_add_to_log( $response, $url, $args, $record );
return $response;
}
function adfoin_housecallpro_build_customer( $fields ) {
$body = array();
foreach ( array( 'firstName' => 'first_name', 'lastName' => 'last_name', 'email' => 'email', 'mobile' => 'mobile_number', 'phone' => 'home_number', 'company' => 'company_name', 'leadSource' => 'lead_source', 'note' => 'notes' ) as $local => $remote ) {
if ( ! empty( $fields[ $local ] ) ) $body[ $remote ] = $fields[ $local ];
}
return $body;
}
/**
* Housecall Pro does not accept an address on customer creation — an
* address is a separate resource created via POST /customers/{id}/addresses
* (confirmed via a working open-source HCP API client).
*/
function adfoin_housecallpro_add_address( $customer_id, $fields, $record, $cred_id ) {
$addr = array();
foreach ( array( 'address' => 'street', 'city' => 'city', 'state' => 'state', 'zip' => 'zip' ) as $local => $remote ) {
if ( ! empty( $fields[ $local ] ) ) $addr[ $remote ] = $fields[ $local ];
}
if ( ! $addr ) return;
if ( ! empty( $fields['country'] ) ) $addr['country'] = $fields['country'];
adfoin_housecallpro_request( "customers/{$customer_id}/addresses", 'POST', $addr, $record, $cred_id );
}
/**
* Housecall Pro Leads are NOT customers with a "lead" flag — they are a
* distinct resource at POST /leads with a nested customer object (a single
* "name" field, not first_name/last_name) and a nested address object
* (confirmed via a working open-source HCP API client).
*/
function adfoin_housecallpro_build_lead( $fields ) {
$body = array();
$name = trim( ( isset( $fields['firstName'] ) ? $fields['firstName'] : '' ) . ' ' . ( isset( $fields['lastName'] ) ? $fields['lastName'] : '' ) );
$customer = array();
if ( $name !== '' ) $customer['name'] = $name;
if ( ! empty( $fields['email'] ) ) $customer['email'] = $fields['email'];
if ( ! empty( $fields['phone'] ) ) $customer['phone'] = $fields['phone'];
elseif ( ! empty( $fields['mobile'] ) ) $customer['phone'] = $fields['mobile'];
if ( $customer ) $body['customer'] = $customer;
$addr = array();
foreach ( array( 'address' => 'street', 'city' => 'city', 'state' => 'state', 'zip' => 'zip' ) as $local => $remote ) {
if ( ! empty( $fields[ $local ] ) ) $addr[ $remote ] = $fields[ $local ];
}
if ( $addr ) $body['address'] = $addr;
foreach ( array( 'leadSource' => 'source', 'note' => 'notes' ) as $local => $remote ) {
if ( ! empty( $fields[ $local ] ) ) $body[ $remote ] = $fields[ $local ];
}
return $body;
}
/**
* Housecall Pro's Create Job endpoint requires a customer_id, not an email.
* Look the customer up by email first (GET /customers supports an "email"
* filter param, confirmed via the same reference client).
*/
function adfoin_housecallpro_find_customer_id( $email, $cred_id ) {
$response = adfoin_housecallpro_request( 'customers?email=' . rawurlencode( $email ), 'GET', array(), array(), $cred_id );
if ( is_wp_error( $response ) ) return '';
$body = json_decode( wp_remote_retrieve_body( $response ), true );
$list = isset( $body['customers'] ) ? $body['customers'] : ( is_array( $body ) ? $body : array() );
return ! empty( $list[0]['id'] ) ? $list[0]['id'] : '';
}
add_action( 'adfoin_housecallpro_job_queue', 'adfoin_housecallpro_job_queue', 10, 1 );
function adfoin_housecallpro_job_queue( $data ) {
adfoin_housecallpro_send_data( $data['record'], $data['posted_data'] );
}
function adfoin_housecallpro_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 = isset( $record_data['field_data'] ) ? $record_data['field_data'] : $record_data;
$cred_id = isset( $data['credId'] ) ? $data['credId'] : ( isset( $record['cred_id'] ) ? $record['cred_id'] : '' );
$fields = array();
foreach ( $data as $k => $v ) {
$parsed = adfoin_get_parsed_values( $v, $posted_data );
if ( $parsed !== '' && $parsed !== null ) $fields[ $k ] = $parsed;
}
if ( $record['task'] === 'create_customer' ) {
$body = adfoin_housecallpro_build_customer( $fields );
$response = adfoin_housecallpro_request( 'customers', 'POST', $body, $record, $cred_id );
if ( ! is_wp_error( $response ) ) {
$customer = json_decode( wp_remote_retrieve_body( $response ), true );
$customer_id = isset( $customer['id'] ) ? $customer['id'] : '';
if ( $customer_id ) adfoin_housecallpro_add_address( $customer_id, $fields, $record, $cred_id );
}
} elseif ( $record['task'] === 'create_lead' ) {
$body = adfoin_housecallpro_build_lead( $fields );
adfoin_housecallpro_request( 'leads', 'POST', $body, $record, $cred_id );
}
}