Les demandes
Comment créer une demande anonyme (sans coordonnées de contact) ?
Notre API ne permet que la création de demandes liées à des contacts nommés. Elle ne vous permet pas de créer de demandes « anonymes » et les noms du type « INCONNU », « NON DEFINI » ou autre ne seront pas admis. Il vous faudra exclure de vos injections de données les demandes sans coordonnées.
Quelle est la différence entre les champs private_note et public_note
- Le champ « private_note » correspond à la note interne (à l’office de tourisme ou l’institution touristique). Elle permet de générer une demande à traiter par l’équipe de la structure dans avizi. Elle sera donc en général utilisée pour les formulaires de contact sur un site internet.
- Le champ « public_note » correspond à une note publique (ou note à destination du contact). Ce champ peut être utilisé pour intégrer un contenu dans un envoi d’email ou un courrier à destination d’un contact. Il peut également être utilisé dans le cas de la création d’un contact associé à une demande auto- traitée (demande qui ne nécessite pas de réponse de la part de l’OT) comme c’est le cas pour vos demandes envoyées au prestataire. Le contact sera créé dans avizi avec sa demande, qui ne transitera pas dans les demandes à traiter.
Les critères Qualif + dans avizi
Qu’est-ce qu’un critère Qualif + ?
Les critères Qualif + viennent préciser une demande ou un contact. Ils sont configurables et donc différents pour chaque client, qui les utilisera par la suite pour réaliser des statistiques ou des ciblages de campagnes.
Il existe principalement 2 types de critères :
- des critères qualifiant des contacts (applicables à différents types de contacts privés ou professionnels)
- des critères qualifiant des demandes
Comment obtenir la liste des critères Qualif + que je peux utiliser ?
Les critères Qualif + doivent être créés par le client sur les environnements de démonstration et de production. La case « Visible via l’API » doit être cochée lors de la création des Qualif+
Vous pouvez obtenir la liste des critères Qualif + et leurs identifiants en utilisant la méthode :
Comment ajouter un critère Qualif + sur une demande ou un contact ?
Quelque soit le type de critère Qualif +, l’ajout s’effectue via l’appel de la méthode suivante :
Dans le cas d’un critère qualifiant un contact, les paramètres à préciser sont les suivants :
Dans le cas d’un critère qualifiant une demande, les paramètres à préciser sont les suivants :
Autres
Nous recevons des alertes d’atteinte de limite API, pourquoi ?
Certaines données peuvent générer de nombreux appels inutiles. Evitez d’effectuer des appels systématiques pour récupérer des données fixes (tels que les pays, civilités, etc.). Nous vous conseillons de stocker ses données en local afin de limiter le nombre d’appels.
Quels identifiants varieront entre le serveur de démonstration et le serveur de production ?
Suite à la validation des utilisateurs pour le passage en production, une nouvelle clé API de production sera ouverte pour vous. Nous vous conseillons évidemment de procéder à quelques tests complémentaires après le passage en production de votre développement, puisque certains éléments devront être mis à jour :
- l’URL d’appel (https://app.avizi.fr)
- les identifiants des critères qualif + et leurs modalités
- les identifiants des listes de diffusion
Pourquoi certaines demandes ne se génèrent-elles pas dans les demandes à traiter ?
Pour qu’une demande soit générée dans les demandes à traiter, le champ « private_note » doit obligatoirement être complété. En l’absence de ce champ, le contact sera créé et une demande auto-traitée sera affichée sur sa fiche contact.
Comment créer un contact avec le message qu’il a envoyé, sans toutefois créer une demande à traiter par l’OT (exemple de widgets prestataires)
Vous pouvez créer des contacts, associés à des demandes directement historisée en utilisant le champ public_note pour contenir son commentaire. Un contact sera alors créé dans avizi, associé à une demande auto- traitée (demande qui ne nécessite pas de réponse de la part de l’OT) comme c’est le cas pour vos demandes envoyées au prestataire. Le contact sera créé dans avizi avec sa demande, qui ne transitera pas dans les demandes à traiter.