> ## Documentation Index
> Fetch the complete documentation index at: https://support.quo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Housecall Pro

Connectez Quo à Housecall Pro pour mettre à jour les coordonnées de vos clients dans Quo toutes les heures et consigner les appels et les messages texte dans les enregistrements clients correspondants.

<h2 id="overview">
  Aperçu
</h2>

L’intégration native de Housecall Pro à Quo rassemble le contexte client dans Quo et garde les activités de communication liées au travail effectué dans Housecall Pro.

<img src="https://mintcdn.com/resource-center/38BQtvC1lyWmtwlO/images/Housecallpro-(2).png?fit=max&auto=format&n=38BQtvC1lyWmtwlO&q=85&s=55ee949eeebee3851853257164baa91e" alt="Housecallpro (2)" width="1710" height="1026" data-path="images/Housecallpro-(2).png" />

Lorsque vous connectez l’intégration, Quo importe vos clients Housecall Pro en tant que contacts. Ces contacts sont ensuite actualisés automatiquement toutes les heures. La synchronisation des contacts est unidirectionnelle, de Housecall Pro vers Quo : Housecall Pro demeure donc la source de référence.

Lorsque Quo parvient à associer de façon fiable un contact à un client Housecall Pro, les appels et les messages texte sont consignés dans l’enregistrement de ce client dans Housecall Pro.

L’intégration est offerte avec les **forfaits Business et Scale de Quo**. Elle nécessite un **forfait MAX ou XL** de Housecall Pro avec accès à l’API. Seul un propriétaire ou administrateur de l’espace de travail Quo peut la connecter, et seul un administrateur Housecall Pro peut générer la clé d’API.

***

<h2 id="what-the-housecall-pro-integration-does">
  Ce que fait l'intégration Housecall Pro
</h2>

<h3 id="syncs-housecall-pro-customers-into-quo">
  Synchronise les clients Housecall Pro dans Quo
</h3>

Quo effectue une importation initiale des clients lorsque l'intégration est connectée. Par la suite, il consulte Housecall Pro toutes les heures pour récupérer les informations clients nouvelles ou mises à jour.

Les données prises en charge comprennent :

* Le nom du client
* Les numéros de téléphone
* Les adresses courriel
* D'autres coordonnées prises en charge, comme l'entreprise ou le poste, lorsqu'elles sont disponibles

La synchronisation des contacts est unidirectionnelle, de Housecall Pro vers Quo. Les contacts importés de Housecall Pro sont en lecture seule dans Quo; apportez donc toute modification aux renseignements des clients directement dans Housecall Pro. Les mises à jour s'afficheront dans Quo après la prochaine synchronisation horaire.

<h3 id="logs-quo-activity-to-housecall-pro-customer-records">
  Consigne l’activité de Quo dans les enregistrements clients de Housecall Pro
</h3>

Lorsque Quo peut associer de façon fiable un contact à un client Housecall Pro, il consigne l’activité prise en charge dans l’enregistrement de ce client :

* Appels entrants et sortants
* Messages texte entrants et sortants

Si Quo ne peut pas associer le contact à un client avec certitude, l’activité demeure accessible dans Quo et rien n’est créé dans Housecall Pro. L’intégration ne crée pas de clients fictifs.

Seules les nouvelles activités sont consignées après la connexion de l’intégration. L’activité antérieure dans Quo n’est pas importée rétroactivement.

***

<h2 id="before-you-connect">
  Avant de vous connecter
</h2>

Vous aurez besoin de ce qui suit :

* Un forfait Quo Business ou Scale
* Un forfait Housecall Pro MAX ou XL avec accès à l’API
* Des autorisations de propriétaire ou d’administrateur de l’espace de travail Quo
* Des autorisations d’administrateur Housecall Pro
* Une clé d’API Housecall Pro avec l’option **Full access**

Une clé d’API en lecture seule permet d’importer les données des clients, mais ne prend pas en charge l’intégration complète, notamment la consignation des activités Quo dans Housecall Pro.

***

<h2 id="create-a-housecall-pro-api-key">
  Créer une clé d’API Housecall Pro
</h2>

1. Connectez-vous à Housecall Pro en tant qu’administrateur.
2. Accédez à **My Apps → All Apps**.
3. Trouvez et ouvrez **API Key Management**.
4. Cliquez sur **Generate API Key**.
5. Donnez à la clé un nom facile à reconnaître, comme **Quo**.
6. Sous Permissions, sélectionnez **Full access**.
7. Cliquez sur **Generate key**, puis copiez la clé d’API.

Traitez la clé d’API comme un mot de passe : conservez-la en lieu sûr et ne la communiquez qu’aux outils et aux personnes qui en ont besoin.

***

<h2 id="connect-housecall-pro-to-quo">
  Connecter Housecall Pro à Quo
</h2>

1. Ouvrez l’application Web ou de bureau de Quo.
2. Accédez à **Paramètres → Intégrations**.
3. Sélectionnez **Housecall Pro**, puis cliquez sur **Connecter**.
   <img src="https://mintcdn.com/resource-center/38BQtvC1lyWmtwlO/images/Housecallpro4.png?fit=max&auto=format&n=38BQtvC1lyWmtwlO&q=85&s=6ba4f06c575b8d26a040887522f299b7" alt="Housecallpro4" width="1710" height="1026" data-path="images/Housecallpro4.png" />
4. Collez la clé d’API de Housecall Pro et terminez la connexion.
   <img src="https://mintcdn.com/resource-center/38BQtvC1lyWmtwlO/images/Housecallpro3-1.png?fit=max&auto=format&n=38BQtvC1lyWmtwlO&q=85&s=f9b60a48d5cfc0fc10888daa09123bde" alt="Housecallpro3" width="1710" height="1026" data-path="images/Housecallpro3-1.png" />
5. Quo valide la clé et lance l’importation initiale des clients.
6. Une fois l’importation initiale terminée, Quo actualise automatiquement les renseignements sur les clients de Housecall Pro toutes les heures.

***

<h2 id="how-contact-matching-works">
  Fonctionnement de l'association des contacts
</h2>

Quo utilise les numéros de téléphone pour associer les contacts aux clients de Housecall Pro.

Pour une association la plus fiable possible :

* Assurez-vous que chaque client de Housecall Pro a un numéro de téléphone à jour.
* Évitez d'attribuer le même numéro de téléphone à des enregistrements de clients qui n'ont aucun lien entre eux.
* Enregistrez les numéros de téléphone dans un format valide, en incluant l'indicatif de pays s'il y a lieu.

Les clients qui n'ont pas de numéro de téléphone utilisable pourraient ne pas être importés ni associés. Si plusieurs clients sans lien entre eux partagent le même numéro, Quo pourrait ne pas être en mesure de déterminer une association fiable et ne consignera pas d'activité en double.

***

<h2 id="find-quo-activity-in-housecall-pro">
  Trouver l'activité Quo dans Housecall Pro
</h2>

1. Ouvrez la fiche du client correspondant dans Housecall Pro.
2. Accédez à la section **Notes** du client
3. Repérez l'entrée correspondant à l'appel ou au message texte Quo, qui comprend un lien profond menant à l'activité dans Quo.

<img src="https://mintcdn.com/resource-center/38BQtvC1lyWmtwlO/images/Housecallpro-(3).png?fit=max&auto=format&n=38BQtvC1lyWmtwlO&q=85&s=9a0429ea9b4edb7d26e6665f1804012d" alt="Housecallpro (3)" width="1710" height="1026" data-path="images/Housecallpro-(3).png" />

***

<h2 id="disconnect-the-integration">
  Déconnecter l’intégration
</h2>

1. Dans Quo, accédez à **Paramètres → Intégrations → Housecall Pro**.
2. Cliquez sur **Déconnecter**.

Une fois l’intégration déconnectée, les contacts ne sont plus actualisés et les activités ne sont plus consignées. Les appels et les messages créés pendant la période de déconnexion ne sont pas consignés rétroactivement après la reconnexion.

Si vous supprimez ou révoquez la clé d’API dans Housecall Pro, l’intégration cessera aussi de fonctionner. Générez une nouvelle clé à accès complet (Full access), puis reconnectez l’intégration dans Quo.

***

<h2 id="faqs">
  FAQ
</h2>

<h3 id="how-often-does-quo-refresh-housecall-pro-contacts">
  À quelle fréquence Quo actualise-t-il les contacts Housecall Pro ?
</h3>

Quo effectue une importation initiale lorsque vous connectez l'intégration, puis actualise automatiquement les renseignements des contacts toutes les heures. Une modification apportée dans Housecall Pro peut donc prendre jusqu'à une heure avant d'apparaître dans Quo.

<h3 id="do-contact-updates-sync-from-quo-back-to-housecall-pro">
  Les mises à jour des contacts sont-elles synchronisées de Quo vers Housecall Pro?
</h3>

Non. La synchronisation des contacts est unidirectionnelle, de Housecall Pro vers Quo. Modifiez les renseignements des clients directement dans Housecall Pro.

<h3 id="which-housecall-pro-plan-do-i-need">
  De quel forfait Housecall Pro ai-je besoin?
</h3>

Il vous faut un forfait Housecall Pro MAX ou XL avec accès à l'API, ainsi qu'un forfait Quo Business ou Scale.

<h3 id="which-api-key-permission-should-i-choose">
  Quelle autorisation de clé d’API dois-je choisir?
</h3>

Choisissez **Full access** pour que Quo puisse importer les renseignements de vos clients et consigner l'activité de communication dans Housecall Pro.

<h3 id="why-is-a-contact-missing-in-quo">
  Pourquoi un contact n’apparaît-il pas dans Quo?
</h3>

Vérifiez les points suivants :

* Le client a un numéro de téléphone valide dans Housecall Pro.
* La synchronisation initiale ou la dernière synchronisation horaire est terminée.
* La clé d’API est toujours active.
* Votre forfait Housecall Pro inclut l’accès à l’API.
* Le même numéro de téléphone n’est pas utilisé par plusieurs clients qui n’ont aucun lien entre eux.

<h3 id="why-didnt-a-call-or-text-appear-in-housecall-pro">
  Pourquoi un appel ou un message texte n’apparaît-il pas dans Housecall Pro ?
</h3>

Quo doit pouvoir associer de façon fiable le contact à un client Housecall Pro, en fonction du numéro de téléphone. Si aucune correspondance n’est trouvée, l’activité reste dans Quo et aucun client fictif n’est créé.

<h3 id="does-the-integration-create-jobs-estimates-or-leads">
  L'intégration crée-t-elle des travaux, des estimations ou des prospects?
</h3>

Non. L'intégration actuelle synchronise les coordonnées des clients dans Quo et consigne les activités prises en charge dans les enregistrements clients existants. Elle ne crée ni travaux, ni estimations, ni prospects dans Housecall Pro.

<h3 id="does-quo-import-historical-calls-and-messages">
  Quo importe-t-il l'historique des appels et des messages?
</h3>

Non. La consignation des activités commence dès que l'intégration est connectée.

***

<h2 id="need-help">
  Besoin d'aide?
</h2>

[Soumettez une demande d'assistance](https://support.quo.com/fr-CA/contact-support/submit-a-request) et nous vous aiderons à établir la connexion.

***