Desarrollo web

¿Como trabajar con la API de Hubspot?

como trabajar con la api de hubspot

¿Qué es HubSpot?

HubSpot es un CRM basado en la nube diseñado para ayudar a alinear los equipos de ventas y de marketing, fomentar la habilitación de las ventas, impulsar el ROI y optimizar su estrategia de marketing entrante para generar más clientes potenciales cualificados. Bien, ¿pero en inglés? HubSpot es una plataforma de software diseñada para ayudar a tu empresa a comercializar y vender con mayor eficacia.

¿Qué es la API de Hubspot?

La API está construida para permitirte crear una aplicación o integración funcional de forma rápida y sencilla. Todas las APIs de HubSpot están organizadas en torno a REST – si ya has interactuado con una API RESTful, muchos de los conceptos te serán familiares. Todas las llamadas a la API de HubSpot deben hacerse al dominio base https://api.hubapi.com.

Librerías de clientes

Las librerías de clientes están diseñadas para ayudarte a interactuar con las APIs de HubSpot más fácilment. Están escritas en varios lenguajes diferentes y ayudan a cerrar la brecha entre tu aplicación y las APIs de HubSpot. Eliminan la necesidad de conocer la URL exacta y el método HTTP a utilizar para cada llamada a la API, entre otras cosas, dejándote más tiempo para centrarte en hacer tu aplicación

Aquí puedes encontrar mñas información de las librerías para cada uno de los lenguajes que se utilizan actualmente: https://developers.hubspot.com/docs/api/overview

En nuestro caso vamos a comentar varios ejemplos en PHP, así que comenzamos.

¿Cómo instalar la librería de PHP para la API de Hubspot?

La mejor manera para instalar la librería de PHP para la API de Hubspot es mediante composer, es simple y rápida y además hace todo el trabajo por ti en cuanto a referencia de clases y demás. Para hacer solo tienes que ir a la raíz de tu proyecto , abrir una consola y escribir lo siguiente:

composer require hubspot/api-client

Con esto ya tenemos la librearía a nuestra disposición para interactuar con ella. Vamos a utilizar la libraría mediante ejemplos para que veas que fácil es realizar acciones con la API de hubspot.

Ejemplo 1: Comprobar que existe un contacto.

$hubSpot = \HubSpot\Factory::createWithApiKey('API-KEY-HUBSPOT');
$filter = new \HubSpot\Client\Crm\Contacts\Model\Filter();$filter
            ->setOperator('EQ')
            ->setPropertyName('email')
            ->setValue($email);
$filterGroup = new \HubSpot\Client\Crm\Contacts\Model\FilterGroup();
$filterGroup->setFilters([$filter]);
$searchRequest = new \HubSpot\Client\Crm\Contacts\Model\PublicObjectSearchRequest();
$searchRequest->setFilterGroups([$filterGroup]);
// @var CollectionResponseWithTotalSimplePublicObject $contactsPage
$contactsPage = $hubSpot->crm()->contacts()->searchApi()->doSearch($searchRequest);

Ejemplo 2: Listar los contactos (Tener en cuenta que el resultado viene con paginación)

$hubSpot = \HubSpot\Factory::createWithApiKey('API-KEY-HUBSPOT');
$contacts = $hubSpot->crm()->contacts()->basicApi()->getPage();

Ejemplo 3: Crear un contacto

$hubSpot = \HubSpot\Factory::createWithApiKey('API-KEY-HUBSPOT');
$contactInput = new \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectInput();
$contactInput->setProperties([
            'email' => $email
        ]);
$response = $hubSpot->crm()->contacts()->basicApi()->create($contactInput);

Ejemplo 4: Actualizar los datos de un contacto

$hubSpot = \HubSpot\Factory::createWithApiKey('API-KEY-HUBSPOT');
$newProperties = new \HubSpot\Client\Crm\Contacts\Model\SimplePublicObjectInput();
$newProperties->setProperties([
            'firstname' => 'Nomre y apellidos',
            'phone'     => 'xxxxxxxxx'
        ]);

$response = $hubSpot->crm()->contacts()->basicApi()->update($contactId, $newProperties);

En este ejemplo tener en cuenta que se atualiza por el $contactId por lo que antes deberiamos recuperar el objecto del contacto por el email, extraer el id y después realizar la actualización.

Estos son 4 sencillos ejemplos de como trabajar con la API de Hubspot, a partir de aquí puedes utilizar en dependencia de tus necesidades. Estos códigos puedes integrarlos en funciones independientes y realizar las llamadas que necesites .

Espero te haya sido útil el artículo y comiences a trabajar fácilmente con la API de Hubspot.

Deja una respuesta