Connexion entre freePBX et Home assistant

De Wiki de Mémoire Vive
Aller à la navigation Aller à la recherche

Voici une proposition de sujet, avec l'éclairage de ChatGPT, mais un peu ambitieux je pense,

La connexion entre FreePBX et Home Assistant peut se faire via une intégration API. Cela vous permettra de contrôler votre système FreePBX à partir de Home Assistant et d'ajouter des automatisations basées sur des événements de FreePBX.

Voici les étapes générales pour connecter FreePBX et Home Assistant via une intégration API :

Configurez FreePBX pour activer l'API REST. Pour cela, allez dans l'interface d'administration de FreePBX, puis dans "Advanced Settings". Recherchez "RestAPI Enabled" et activez-le. Notez l'URL de l'API REST.

Configurez Home Assistant pour ajouter une intégration FreePBX. Pour cela, allez dans l'interface d'administration de Home Assistant, puis dans "Integrations". Recherchez "FreePBX" et suivez les instructions pour ajouter l'intégration. Lorsque vous y êtes invité, entrez l'URL de l'API REST de FreePBX et les identifiants d'authentification.

Une fois que l'intégration est configurée, vous pouvez utiliser des automatisations pour déclencher des actions dans FreePBX en réponse à des événements dans Home Assistant. Par exemple, vous pouvez configurer une automatisation pour que lorsque le détecteur de mouvement détecte un mouvement dans une pièce, un appel soit lancé vers votre téléphone via FreePBX.

Vous pouvez également créer des boutons dans Home Assistant pour contrôler directement des fonctions de FreePBX, comme passer un appel ou activer/désactiver une fonctionnalité de FreePBX.

EXEMPLE

Voici un exemple d'intégration entre Home Assistant et FreePBX à l'aide de l'API REST :

Tout d'abord, vous devez activer l'API REST sur votre serveur FreePBX. Pour cela, connectez-vous à l'interface d'administration de FreePBX et accédez à la section "Advanced Settings". Recherchez "RestAPI Enabled" et activez-le.

Dans Home Assistant, ajoutez une intégration FreePBX en accédant à la section "Configuration" puis "Intégrations". Cliquez sur le bouton "Ajouter une intégration" et recherchez "FreePBX". Sélectionnez l'intégration et entrez l'URL de l'API REST de FreePBX, ainsi que vos identifiants d'authentification.

Une fois que l'intégration est ajoutée, vous pouvez accéder à des services spécifiques de FreePBX via Home Assistant. Par exemple, vous pouvez ajouter un bouton dans l'interface de Home Assistant qui lancera un appel vers un numéro spécifique via FreePBX. Pour cela, vous devez ajouter une automation dans Home Assistant. Voici un exemple de code YAML pour une telle automation :

yaml

automation:
 - alias: "Appeler le service client"
   trigger:
     platform: state
     entity_id: input_boolean.call_service
     to: "on"
   action:
     service: freepbx.call
     data:
       number: "+33123456789"

Dans cet exemple, une automation est créée qui déclenchera un appel vers le numéro "+33123456789" lorsqu'un bouton est activé dans l'interface de Home Assistant. Le service "freepbx.call" est utilisé pour lancer l'appel, et les données spécifiques sont passées via le champ "data". Cet exemple utilise l'intégration FreePBX fournie par le composant de base de Home Assistant. Si vous avez besoin de fonctionnalités plus avancées, vous pouvez également utiliser des scripts Python personnalisés pour communiquer avec l'API REST de FreePBX.