Vue d'ensemble

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 la key d’un champ personnalisé de Lister les champs personnalisés.
operator : l’un de IS, 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 renvoie INVALID_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 comme created_at. Sinon la requête renvoie INVALID_FILTER_VALUE. Ignorée pour EMPTY et NOT_EMPTY.

Les filtres d’une vue utilisent des conditions explicites { field, operator, value }, contrairement à l’objet filters nommé de Rechercher des personnes. C’est voulu : une vue créée dans l’app ressort de l’API exactement comme elle a été enregistrée, et une vue créée via l’API s’ouvre dans l’app sans changement.

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.

API

Webhooks

Conversations

CRM

Personnes

Champs personnalisés

Vues

Entreprises

Deals

Notes

Fils de discussion

Numéros de téléphone

Réceptionniste IA

Tags

Modèles de résumé

Utilisateurs

SMS

Analytiques

Power Dialer

Partner

Scopes

L’objet vue

Filtres

Tri

Vues privées et vues d’équipe

Endpoints

Lister les vues

Obtenir une vue

Créer une vue

Modifier une vue

Supprimer une vue

​Scopes

​L’objet vue

​Filtres

​Tri

​Vues privées et vues d’équipe

​Endpoints

Lister les vues

Obtenir une vue

Créer une vue

Modifier une vue

Supprimer une vue

Scopes

L’objet vue

Filtres

Tri

Vues privées et vues d’équipe

Endpoints