Une vue est un filtre et un tri nommés sur vos personnes, les mêmes vues que vous créez sur la page Contacts de l'app Allo. Les vues créées dans l'app et via l'API sont les mêmes objets. L'API Vues permet de les lister, les créer, les modifier et les supprimer.
Scopes
| Scope | Accès |
|---|---|
CRM_READ | Lister et lire les vues |
CRM_WRITE | Créer et modifier des vues |
CRM_DELETE | Supprimer des vues |
L'objet vue
| Champ | Type | Description |
|---|---|---|
id | string | ID public de la vue, préfixé cvw_ |
name | string | Nom affiché, 255 caractères maximum |
filters | array | Conditions { field, operator, value }, combinées avec ET |
sort | array | 2 entrées { field, order } maximum. order vaut asc ou desc |
owner_type | string | USER ou TEAM |
user_id | string | ID de l'utilisateur propriétaire de la vue |
team_id | string ou null | ID de l'équipe, pour une vue TEAM |
created_at | string | Date de création |
updated_at | string | Date de dernière modification |
{
"id": "cvw_2abc",
"name": "Hot leads",
"filters": [
{
"field": "company",
"operator": "CONTAINS",
"value": "Acme"
}
],
"sort": [
{
"field": "created_at",
"order": "desc"
}
],
"owner_type": "USER",
"user_id": "usr_2abc",
"team_id": null,
"created_at": "2026-10-23T10:00:00",
"updated_at": "2026-10-23T10:00:00"
}
Filtres
Chaque filtre est une condition { field, operator, value }, et toutes les conditions d'une vue sont combinées avec ET, 50 maximum par vue. value est toujours une chaîne.
field: un champ natif d'une personne (name,company,job_title,emails,phone_numbers,website,addresses,created_at,updated_at,last_activity,activity_history,sms_content(uniquement si l'équipe a des SMS)) ou lakeyd'un champ personnalisé de Lister les champs personnalisés.operator: l'un deIS,IS_NOT,CONTAINS,NOT_CONTAINS,EMPTY,NOT_EMPTY,STARTS_WITH,ENDS_WITH,BEFORE,AFTER,DATE_EQUALS,GREATER_THAN,GREATER_THAN_OR_EQUAL,LESS_THAN,LESS_THAN_OR_EQUAL,HAS. L'opérateur doit correspondre au type du champ, sinon la requête renvoieINVALID_FILTER_OPERATOR.value: doit être lisible pour le type du champ : numérique pour un champ nombre, une date ISO 8601 (2026-01-31) ou date-heure (2026-01-31T00:00:00Z) pour un champ date commecreated_at. Sinon la requête renvoieINVALID_FILTER_VALUE. Ignorée pourEMPTYetNOT_EMPTY.
Tri
sort accepte 2 entrées maximum, chacune avec un field et un order (asc ou desc). Les champs natifs triables sont name, company, job_title, website, created_at, updated_at, last_activity. Vous pouvez aussi trier sur la key d'un champ personnalisé triable de Lister les champs personnalisés. Un field inconnu renvoie INVALID_SORT_FIELD, et un champ qui ne peut pas être trié renvoie FIELD_NOT_SORTABLE.
Vues privées et vues d'équipe
owner_type vaut USER par défaut : la vue est privée pour l'utilisateur de la clé API. Passez-le à TEAM pour partager la vue avec l'équipe de cet utilisateur ; si l'utilisateur n'a pas d'équipe, la requête renvoie 400 USER_HAS_NO_TEAM. Modifier ou supprimer une vue d'équipe exige d'en être le propriétaire ou ADMIN ou MANAGER de l'équipe, sinon la requête renvoie 403 VIEW_PERMISSION_DENIED. La vue privée d'un autre utilisateur ne vous est pas visible et renvoie 404 VIEW_NOT_FOUND.