Visitor identification

Generate a visitor identification token

Générez un jeton d’identification pour un visiteur du site Web qui a été authentifié à l’aide de votre propre système. Un jeton d’identification renvoyé par cette API peut être utilisé pour transmettre des informations sur votre visiteur déjà authentifié au widget de chat, afin qu’il traite le visiteur comme un contact connu. Cela permet aux agents du support de reconnaître et d’aider le visiteur plus efficacement.

POST

visitor-identification

tokens

create

Générer un jeton visiteur

curl --request POST \
  --url https://api.hubapi.com/visitor-identification/v3/tokens/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "hsCustomerAgentContext": {},
  "firstName": "<string>",
  "lastName": "<string>"
}
'

{
  "token": "<string>"
}

Supported products

Required Scopes

Autorisations

Authorization

string

header

requis

The access token received from the authorization server in the OAuth 2.0 flow.

Corps

application/json

string

requis

L'e-mail du visiteur que vous souhaitez identifier

hsCustomerAgentContext

object

requis

Show child attributes

firstName

string

Le prénom du visiteur que vous souhaitez identifier. Cette valeur ne sera définie dans HubSpot que pour les nouveaux contacts et les contacts existants dont le prénom est inconnu. Facultatif.

lastName

string

Le nom de famille du visiteur que vous souhaitez identifier. Cette valeur ne sera définie dans HubSpot que pour les nouveaux contacts et les contacts existants dont le nom de famille est inconnu. Facultatif.

Réponse

successful operation

token

string

requis

Un jeton d'identification qui permet au visiteur d'être traité comme un contact connu.

Last modified on April 13, 2026

Identification des visiteurs

HubSpot CRM embed

⌘I