Allo

Vue d'ensemble

Gérez les vues de contacts enregistrées dans votre CRM Allo

Mis à jour le

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

ScopeAccès
CRM_READLister et lire les vues
CRM_WRITECréer et modifier des vues
CRM_DELETESupprimer des vues

L'objet vue

ChampTypeDescription
idstringID public de la vue, préfixé cvw_
namestringNom affiché, 255 caractères maximum
filtersarrayConditions { field, operator, value }, combinées avec ET
sortarray2 entrées { field, order } maximum. order vaut asc ou desc
owner_typestringUSER ou TEAM
user_idstringID de l'utilisateur propriétaire de la vue
team_idstring ou nullID de l'équipe, pour une vue TEAM
created_atstringDate de création
updated_atstringDate 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.

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.

Endpoints