============
Installation
============

Voraussetzungen
===============

innovaphone PBX mit App-Plattform mindestens in Version V13r2sr11

App Installation
----------------

Die App muss auf der App-Plattform installiert sein.
Laden Sie eine neue App mit dem ``neue App hochladen`` Button hoch.

.. thumbnail:: install_app.png

Sobald die Installation erfolgreich abgeschlossen ist, können die App-Instanzen eingerichtet werden.

Konfiguration der Instanz
=========================

Instanz einrichten
------------------

Nachdem die App installiert wurde, kann eine Instanz eingerichtet werden.
Die Instanz muss entsprechend der Systemumgebung konfiguriert werden.

.. thumbnail:: install_create_instance__en.png

Nach Erstellung der App Instanz muss diese über den ``Start-Knopf`` gestartet werden, 
sobald die App läuft, taucht diese im ``PBX-Manager`` auf.

PBX-Objekte anlegen
-------------------

Über den PBX-Manager muss ein PBX-Objekt für die Admin-App angelegt werden.

.. thumbnail:: install_add_app_pbx_manager__en.png
   :width: 185px
   :height: 60px

   Konfiguration im PBX-Manager

Der Name dieser Einträge dient als Beschriftung für die Einträge in den myApps Clients.
In diesem Fall bietet sich ``GrpApi Admin`` als Name an und als SIP ``grpapiadmin``.

.. thumbnail:: install_add_app_pbx_manager_admin__en.png

   Konfiguration Admin App im PBX-Manager

Die Checkboxen stellen alle verfügbaren Templates dar. Der User-App wird das entsprechende User-Template zugewiesen und der Admin-App das zugehörige Admin-Template.

Wenn alles geklappt hat, werden grüne Haken hinter den App-Objekten angezeigt.
Die Apps sind nun den einzelnen Anwender:innen zugewiesen. Diese können sich die App nun hinzufügen.

Konfiguration der App
=====================

In der App selbst müssen nun weitere Einstellungen vorgenommen werden.

.. thumbnail:: configuration_app.png

- **Authtoken**: Der Bearer Token zur Verwendung in HTTP Anfragen
- **Systemdomain**: Die Systemdomain des PBX Systems
- **Master Pbx**: Der Name der Master Pbx im System

Nachdem diese Einstellungen vorgenomen wurden, ist die App bereit um API Anfragen entgegen zu nehmen.