Quick start tutorial on installing and using Hubspot PHP SDK with Laravel

use Rossjcooper\\LaravelHubSpot\\Facades\\HubSpot;

class SomeController extends Controller
{
public function index(Request $request)
{
try {
$contacts = Hubspot::contacts()->all();
} catch (\\Exception | NotFoundException | BadRequest $e) {
// this will show you the error messages in thier entirity, becasue Guzzle trucates them "helpfully"
if(method_exists($e, 'getResponse')) {
$response = $e->getResponse();
$responseBodyAsString = $response->getBody()->getContents();
dd($e, $responseBodyAsString);
} else {
dd($e);
}
}
dd($contacts);
}
}

// RegisterController.php or LoginController.php or similar
public function store(Request $request)
{
// Store new customer details and/or log them in, whatever else you want to do
...

// HubSpot -----

// New company
// Docs: https://developers.hubspot.com/docs/methods/companies/create_company
// NOTE: This call takes a list of array's directly
$company = Hubspot::companies()->create(\[
\[
"name" => "name", // NOTE: The key is 'name' for this call, but 'property' in the contact call below - oh boy!
"value" => $request->user()->company->name // I'm assuming that you have a relationship between a User and a Company within your own system
\],\[
"name" => "description",
"value" => "<Company notes here>"
\]
\]);

// New contact
// Docs: https://developers.hubspot.com/docs/methods/contacts/create_contact
// NOTE: This call takes an array of array's!
$contact = Hubspot::contacts()->create(\[
\[
'property' => 'email', // NOTE: Using 'property' as the key value, you need to check every call as to which is the right one to use
'value' => $request->user()->email
\],\[
'property' => 'firstname',
'value' => $request->user()->first_name
\],\[
'property' => 'lastname',
'value' => $request->user()->last_name
\],\[
'property' => 'company',
'value' => $request->user()->company_name
\],\[
'property' => 'phone',
'value' => $request->user()->phone
\],\[
'property' => 'address',
'value' => $request->user()->address
\],\[
'property' => 'country',
'value' => $request->user()->country
\],\[
'property' => 'city',
'value' => $request->user()->city
\],\[
'property' => 'state',
'value' => $request->user()->state
\],\[
'property' => 'zip',
'value' => $request->user()->zip
\]
\]);

// Now we assoicate the Contact with the Company
// Docs: https://developers.hubspot.com/docs/methods/crm-associations/crm-associations-overview
Hubspot::crmassociations()->create(\[
"fromObjectId" => $contact->vid, // 'ContactId' in hubspot - this value is dictated by the definitionId below
"toObjectId" => $company->companyId, // 'CompanyId' in hubspot - this value is dictated by the definitionId below
"category" => "HUBSPOT_DEFINED",
"definitionId" => 1 // Defines the objects you are connecting - in this case Contact -> Company
\]);
}

// List of accepted fields in hubspot - because for some reason it's not in thier docs - yay
$contact_properties = Hubspot::ContactProperties()->all();
foreach($contact_properties->getData() as $contact_property) {
if($contact_property->formField) { // hide internal fields
echo $contact_property->name.'<br/>';
}
}

// TicketController.php or similer
public function store(Request $request)
{
// validate fileds, do local work
...

// HubSpot: Create ticket
// docs: https://developers.hubspot.com/docs/methods/tickets/create-ticket
try {
// Array of arrays...
$ticket = Hubspot::tickets()->create(\[
\[
"name" => "subject", // NOTE: 'name' property...
"value" => $formData\['subject'\]
\],
\[
"name" => "content",
"value" => $formData\['content'\]
\],
\[
"name" => "hs_pipeline",
"value" => "0"
\],
\[
"name" => "hs_pipeline_stage",
"value" => "1"
\]
\]);

    // Assoicate user with company: Company to Ticket
    // Docs: https://developers.hubspot.com/docs/methods/crm-associations/crm-associations-overview
    Hubspot::crmassociations()->create([
      "fromObjectId" => $request->user()->company->hubspot_company_id,
      "toObjectId" => $ticket->objectId,
      "category" => "HUBSPOT_DEFINED",
      "definitionId" => 25
    ]);

} catch (\\Exception | NotFoundException | BadRequest $e) {
if(method_exists($e, 'getResponse')) {
$response = $e->getResponse();
$responseBodyAsString = $response->getBody()->getContents();
dd($e, $responseBodyAsString);
} else {
dd($e);
}
}

// Handle uploaded file(s) here...
}

// Upload file
// Docs: https://developers.hubspot.com/docs/methods/files/post_files
if ($request->has('file')) {
try {
// Create a folder for the ticket
$folder_path = 'ticket_'.$ticket->objectId; // lets keep the files in corrosponding folders to help keep things organised
Hubspot::files()->createFolder($folder_path, null);

    // Upload files to folder - must create a path for each file
    $folder_paths = [];
    foreach($request->file as $k => $p) {
      array_push($folder_paths, $folder_path);
    }
    $uploads = Hubspot::files()->batchUpload($request->file, ['folder_paths' => $folder_paths]);
    
    // Create an engagement (attach the uploaded files as notes to the ticket, compony and contact)
    // Docs: https://developers.hubspot.com/docs/methods/engagements/create_engagement
    $uploadIds = [];
    foreach($uploads->data->objects as $upload) {
      array_push($uploadIds, ['id' => $upload->id]);
    }
    Hubspot::engagements()->create([
      "active" => true,
      "ownerId" => $request->user()->hubspot_vid,
      "type" => "NOTE",
    ],[
      "ticketIds" => [$ticket->objectId],
      "companyIds" => [$request->user()->company->hubspot_company_id],
      "contactIds" => [$request->user()->hubspot_contact_vid],
    ],[
      "body" => "Attached files for ticket: ".$ticket->objectId
    ], $uploadIds);

} catch (\\Exception | NotFoundException | BadRequest $e) {
if(method_exists($e, 'getResponse')) {
$response = $e->getResponse();
$responseBodyAsString = $response->getBody()->getContents();
dd($e, $responseBodyAsString);
} else {
dd($e);
}
}
}

public function index(Request $request)
{
// get ticket pipeline stages for human readable display
$pipelines = Hubspot::crmpipelines()->all('tickets');
$pipelineStages = \[\];
foreach($pipelines->data->results\[0\]->stages as $stage) {
$pipelineStages\[$stage->stageId\] = $stage->label;
}

// get users tickets
$ticketsAssociations = HubSpot::crmassociations()->get($request->user()->company->hubspot_company_id, 25, \['limit' => 50\]);
$hasmore = $ticketsAssociations->data->hasMore;

// debug: show all ticket properties
// $object_properties = HubSpot::ObjectProperties('ticket')->all();
// foreach($object_properties->data as $op) {
//     echo $op->name.' | '.$op->type.'<br/>';
// }
// dd($object_properties);

$tickets = \[\];
foreach($ticketsAssociations->data->results as $ticketId) {
array_push($tickets, HubSpot::tickets()->getById($ticketId, \[
'properties' => \[
'subject',
'content',
'createdate',
'closed_date',
'last_engagement_date',
'hs_pipeline',
'hs_pipeline_stage'\]
\])
);
}

// Sort tickets by date desc
$tickets = collect($tickets)->sortBy(function ($ticket, $key) {
return $ticket->data->properties->createdate->value;
})->reverse();

return view('support.index', compact('tickets', 'hasmore', 'pipelineStages'));
}

@inject('carbon', 'Carbon\\Carbon')
...
@foreach ($tickets as $ticket)
{{ $pipelineStages\[$ticket->properties->hs_pipeline_stage->value\] }}<br/>
{{ $ticket->properties->subject->value }}<br/>
{{ Illuminate\\Support\\Str::limit($ticket->properties->content->value, 40) }}<br/>
{{ $carbon::createFromTimestampMs($ticket->properties->createdate->value)->format("j M, Y g:i:s A") }}<br/>
<a href="{{ route('ticket', $ticket->data->objectId) }}">View ticket</a><br/>
<hr/>
@endforeach
...

public function index(Request $request, $ticketId) {
$ticket = Hubspot::tickets()->getById($ticketId, \['properties' => \[
'subject',
'content',
'createdate',
'closed_date',
'last_engagement_date',
'hs_pipeline',
'hs_pipeline_stage'\]\]
);
$ticket = $ticket->data;

// get engagements for this ticket
$engagements = Hubspot::engagements()->all();
$engagements = $engagements->data->results;

// Sort engagements
$engagements = collect($engagements)->sortBy(function ($engagement, $key) {
return $engagement->engagement->createdAt;
})->reverse();

// Get ticket pipeline stages for lookups
$pipelines = Hubspot::crmpipelines()->all('tickets');
$pipelineStages = \[\];
foreach($pipelines->data->results\[0\]->stages as $stage) {
$pipelineStages\[$stage->stageId\] = $stage->label;
}

return view('support.show', compact('ticket', 'engagements', 'pipelineStages'));
}

Title: {{ $ticket->properties->subject->value) }}<br/>
Description: {{ $ticket->properties->content->value }}
Status: {{ $pipelineStages\[$ticket->properties->hs_pipeline_stage->value\] }}</p>
<h3>Activity:</h3>
@foreach($engagements as $engagement)
@if($engagement->engagement->type != 'TASK')
@if($engagement->engagement->type  == 'EMAIL' || $engagement->engagement->type == 'INCOMING_EMAIL')
<strong>Email:</strong> {!! $engagement->metadata->subject ?? '-' !!}
@elseif($engagement->engagement->type == 'NOTE')
<strong>Note</strong>
@endif
<br/><small class="for-tablet-portrait-up">{{ $carbon::createFromTimestampMs($engagement->engagement->createdAt)->format("j M, Y g:i:s A") }}</small>

      @if($engagement->engagement->type == 'EMAIL' || $engagement->engagement->type == 'INCOMING_EMAIL')
          {!! $engagement->metadata->html !!}</p>
      @elseif($engagement->engagement->type == 'NOTE')
          @if(isset($engagement->metadata->body))
          {!! $engagement->metadata->body !!} 
      @else
          <p>File(s) uploaded.</p>
      @endif
    @else
        ----
    @endif 

@endif  
@endforeach

$object_properties = HubSpot::ObjectProperties('ticket')->all();
foreach($object_properties->data as $op) {
echo $op->name.' | '.$op->type.'<br/>';
}
dd($object_properties);

dd(Hubspot::files()->folders());

dd(Hubspot::files()->all());

// Purge script
/**

* Cleans out Hubspot. All of it must go - **USE WITH EXTREME CAUTION**
  \*/
  function purge() {
  echo "Running purge! You might have to run it a few times if you have a lot of content as it caps at 100 records per call";

  // Delete files
  $files = Hubspot::Files()->all();
  $count = 0;
  foreach($files->data->objects as $file) {
  Hubspot::Files()->delete($file->id);
  $count++;
  }
  echo "\\nDeleted files: ".$count;

  // Delete folders
  $folders = Hubspot::Files()->folders();
  $count = 0;
  foreach($folders->data->objects as $folder) {
  Hubspot::Files()->deleteFolder($folder->id);
  $count++;
  }
  echo "\\nDeleted folders: ".$count;

  // Delete tickets
  $tickets = Hubspot::Tickets()->all();
  $count = 0;
  foreach($tickets->data->objects as $ticket) {
  Hubspot::Tickets()->delete($ticket->objectId);
  $count++;
  }
  echo "\\nDeleted tickets: ".$count;

  // Delete users
  $contacts = Hubspot::Contacts()->all();
  $count = 0;
  foreach($contacts->data->contacts as $contact) {
  Hubspot::Contacts()->delete($contact->vid);
  $count++;
  }
  echo "\\nDeleted contacts: ".$count;

  // Delete companies
  $companies = Hubspot::Companies()->all();
  $count = 0;
  foreach($companies->data->companies as $company) {
  Hubspot::Companies()->delete($company->companyId);
  $count++;
  }
  echo "\\nDeleted companies: ".$count;

  // Engagements
  $engagements = Hubspot::Engagements()->all();
  $count = 0;
  foreach($engagements->data->results as $engagement) {
  Hubspot::Engagements()->delete($engagement->engagement->id);
  $count++;
  }
  echo "\\nDeleted Engagements: ".$count."\\n";
  }