Crear o editar un contacto – addupdatelead

Como funciona

Puede agregar nuevos contactos a su cuenta de Soloclic realizando una solicitud a la API de servicio mediante programación.

La solicitud se envía mediante el método POST en formato URLencode a la dirección: https://username.soloclic.com/api/addupdatelead, donde username es el login del usuario en el sistema y su dominio de 3er nivel en el servicio Soloclic.

En respuesta a la solicitud, su sistema recibirá el resultado de la ejecución de la función en formato JSON. Por ejemplo, algo como esto:

{"error_code":0,"error_text":"OK","result":[],"hash":"******************************"}

Para obtener más información, consulte el artículo «Respuestas de API de servicio«.

Parámetros recibidos en respuesta

Los parámetros de solicitud son los siguientes, el parámetro obligatorio es «rps_key», su clave de API:

• rpsKey – clave API; la clave de su cuenta se encuentra en la sección «Integración y API», el enlace a la sección está en el pie de página de su cuenta personal o aquí /shops/setts/apisettings/
• add_to_lists – a qué grupos agregar el contacto; cadena, los ID de grupo (s) se indican, separados por comas (edición de grupo => pestaña API, por ejemplo, 1473249885.2899961004)
• remove_from_lists – de qué grupos eliminar un contacto; cadena, los ID de grupo se indican, separados por comas (edición de grupo => pestaña API, por ejemplo, 1473249885.2899961004)
• add_tags – qué etiquetas agregar al contacto; línea; etiquetas separadas por comas
• remove_tags – qué etiquetas eliminar del contacto; línea; etiquetas separadas por comas (eliminar etiquetas de contacto)
• lead_email – correo electrónico de contacto (si no se especifica, se creará sin correo electrónico); línea
• lead_first_name – nombre del contacto; línea
• lead_middle_name – segundo nombre del contacto; línea
• lead_last_name – apellido del contacto; línea
• lead_phone – número de teléfono de contacto; línea
• lead_utc – zona horaria de contacto (UTC + 03, +03, -01, 3, -1); línea
• lead_description: información sobre el cliente, visible en la tarjeta de contacto; línea
• lead_personal_manager: identificación del administrador personal del contacto (la identificación se toma del enlace de edición del empleado /tiendas/acceso/)
• lead_shipping_address_1 – dirección de entrega, visible en la tarjeta de contacto; línea
• lead_shipping_address_2 – dirección de entrega (se recomienda utilizarla como campo adicional en caso de direcciones complejas), visible en la tarjeta de contacto, se indicará con una coma después de la dirección anterior; línea
• lead_shipping_city – dirección de entrega (se recomienda usar para una ciudad), visible en la tarjeta de contacto, se indicará con una coma después de la dirección anterior; línea
• lead_shipping_zip – dirección de entrega (se recomienda usarla para el índice), visible en la tarjeta de contacto, se indicará con una coma después de la dirección anterior; línea
• lead_shipping_country_code: código del país de entrega; línea; enviar en el formato [códigos ISO de país] (por ejemplo, «EE. UU.», «CA», etc.), en la tarjeta de contacto se reemplazará automáticamente por el país (por ejemplo, «EE. UU.» se convertirá en «Estados Unidos de América»)
• lead_shipping_state: la dirección de envío (recomendada para la región / estado), visible en la tarjeta de contacto, se indicará con una coma después de la dirección anterior; línea
• lead_billing_address_1 – la dirección de facturación (recomendada para el índice), visible en la tarjeta de contacto, se especificará con una coma después de la dirección anterior; línea
• lead_billing_address_2 – dirección de facturación (se recomienda usarla como un campo adicional en caso de direcciones complejas), visible en la tarjeta de contacto, se indicará con una coma después de la dirección anterior; línea
• lead_billing_city – la dirección de facturación (recomendada para una ciudad), visible en la tarjeta de contacto, se especificará con una coma después de la dirección anterior; línea
• lead_billing_state: la dirección de facturación (recomendada para la región / estado), visible en la tarjeta de contacto, se especificará con una coma después de la dirección anterior; línea
• lead_billing_zip – dirección de facturación (se recomienda usarla para el índice), visible en la tarjeta de contacto, se indicará con una coma después de la dirección anterior; línea
• lead_billing_country_code: código de país para la facturación; línea; enviar en el formato [códigos ISO de país] (por ejemplo, «EE. UU.», «CA», etc.), en la tarjeta de contacto se reemplazará automáticamente por el país (por ejemplo, «EE. UU.» se convertirá en «Estados Unidos de América»)
• lead_facebook – ID de contacto de Facebook; línea lead_instagram – identificación de contacto en Instagram; línea
• lead_whatsapp – identificación de contacto en Whatsapp; línea
• lead_telegram – identificación de contacto en Telegram; línea
• lead_viber – identificación de contacto en Viber; línea
• lead_vkontakte – identificación de contacto en Vkontakte; línea
• lead_in – id del contacto en LinkedIn; línea

Para cambiar el valor de un campo adicional, pase el valor del parámetro

• ex_fields[1]

donde «1» es el id del campo adicional. Puede tomarlo en la columna «id» para campos de CRM adicionales

Ejemplo de PHP (cURL)

<?php 
  $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://username.soloclic.com/api/addupdatelead',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('rpsKey' => 'API key','lead_email' => '[email protected]','add_to_lists' => '1594725950.5982672784,1605870811.1867176380','remove_from_lists' => '1534723950.5982672783','add_tags' => 'tag2020'),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
 
?>