Projekt starten
AlexaAllgemeinPHP

Erstellen einer Alexa-Kompetenz mit PHP – Tutorial

· von Daniel

Seit meinem letzten Tutorial hat sich bei Amazons Alexa-Entwicklerplattform einiges geändert. Die Oberfläche wurde überarbeitet, und statt Intents manuell anzulegen, gibt es jetzt den Skill Builder. Deshalb gibt es hier ein kleines Update meines alten Alexa-PHP-Tutorials. Die Skill-Übersicht Los geht’s. Ich gehe davon aus, dass Sie ein Alexa-Entwicklerkonto haben, und springe direkt ins neue Dashboard. Über „Your Alexa Consoles“ (oben rechts) > Skills gelangen Sie zur Skill-Übersicht. Einen Skill erstellen Unter „Create Skill“ legen wir unseren ersten eigenen Alexa-Skill an. Nach dem Klick auf den Button vergeben Sie im ersten Schritt einen Skill-Namen – in meinem Beispiel „Daniel“. Dann wählen wir das Modell für den Skill. Wir fangen klein an und bauen nicht gleich einen Smart-Home- oder Video-Skill, deshalb wählen wir hier „Custom“.

Skill-Einstellungen

Dashboard für Fertigkeiten

Das war’s: Jetzt steigen Sie in das Armaturenbrett Ihres Könnens. In der oberen Leiste finden Sie die folgenden Punkte:

  • Daniel => Name Ihrer Kompetenz
  • Build => Hier erstellen wir die Befehle
  • Test => Damit wir die Funktionen später überprüfen können
  • Launch => Wenn Sie Ihre Skills im Amazon Store veröffentlichen möchten
  • Messen => Nutzungsverhalten etc.

Unter Build in der linken Sidebar ist die wichtigste – die Skill-Aufrufe und Einstellungen.

Name der Anrufung

In der rechten Leiste finden Sie eine praktische Checkliste mit allen nötigen Schritten. Wir beginnen mit „1. Invocation Name“. Der Aufrufname ist der Startbefehl, mit dem Alexa Ihren Skill anspricht, z. B. „Alexa, frage INVOCATION NAME“. Ich nehme „daniel“ als Beispiel – wichtig: Großbuchstaben sind hier nicht erlaubt.

Erstellen einer Absicht

Nachdem wir den Namen der Anrufung festgelegt haben, können wir unsere erste Skill-Absicht (Intent) erstellen. Ein Intent ist ein Befehl, der auf Ihrem Server ausgeführt wird, wenn eine der zugehörigen Äußerungen (Utterances) erkannt wird. Es klingt nicht kompliziert.Hier ist ein Beispiel:

  • Absicht=Hallo
  • Utterances
    • Hallo
    • Hallo
    • moin

Wenn Sie Ihren Skill jetzt mit „Hallo“ ansprechen, wird der Intent „Hallo“ auf Ihrem Server ausgeführt. Was dieser Intent zurückgibt, hängt von Ihrer Programmierung ab.

Fertigkeits-Überschreitungen & Slots

Wir haben jetzt einen Intent „Hallo“ angelegt. Nun erstellen wir wie oben beschrieben drei Äußerungen (Utterances): Hallo, Hi und Moin. Außerdem soll ein Slot (also eine Variable) an meinen Server übertragen werden. Ich füge einen Slot „name“ mit dem Slot-Typ „AMAZON.DE_FIRST_NAME“ hinzu. Natürlich muss ich ihn mit geschweiften Klammern in die Äußerungen einbauen. Jetzt ist unser erster Intent fertig.

Einen Endpunkt festlegen

Jetzt können wir einen Endpunkt festlegen. Der Endpunkt ist die Adresse, an die die Anfragen Ihres Skills gesendet werden – in meinem Fall https://alexa.welaunch.io. Wichtig ist, dass der Endpunkt über eine verschlüsselte Verbindung (https) erreichbar ist. Wählen Sie HTTPS, geben Sie die Adresse ein und wählen Sie „My development endpoint has a certificate from a trusted certificate authority“. Gehen Sie dann zurück zum Interaktionsmodell und klicken Sie auf „Build Model“.

Der PHP-Teil

Nun können wir endlich zum Thema PHP kommen. Eigentlich ändert sich hier nicht viel im Vergleich zu meinem alten Tutorial, aber ich erkläre es noch einmal kurz. Als Logger benutze ich Monolog, um zu prüfen, warum einige Fragen nicht beantwortet wurden. So sehen Sie auch, welche Intents oder Äußerungen abgefragt werden, die Ihr Skill noch nicht unterstützt. Wenn ich zum Beispiel „hiderido“ sage, fehlt diese Äußerung. Composer-Datei für Monolog:

{
    "name": "db-dzine/alexaphp",
    "description": "PHP Class for Alexa",
    "type": "library",
    "authors": ,
    "minimum-stability": "dev",
    "require": {
        "monolog/monolog": "1.x-dev",
    }
}

Führen Sie danach composer install in Ihrem Ordner aus. Dann können Sie eine index.php erstellen und Autoload und Monolog laden:

<?php // Load Monolog Vendor require_once __DIR__ . '/vendor/autoload.php'; // Autoload files using Composer autoload use Monolog\Logger; use Monolog\Handler\StreamHandler; // Save Requests on debug log define('DEBUG', true); define('DEBUG_FILE', __DIR__ . '/logs/log.log'); $logger = new Logger('Alexa'); $logger->pushHandler( new StreamHandler( DEBUG_FILE, Logger::INFO ) );

Um requests von eurem Skill zu catchen:

// Get Alexa Request
$jsonRequest = file_get_contents('php://input');
// Decode the Request
$data        = json_decode($jsonRequest, true);
// Abort when Empty
if( empty($data) || (!isset($data) ) ) {
	die('Bad Request');
}

Die folgenden Variablen lassen sich aus dem Daten-Array auslesen. Natürlich steckt noch mehr darin, aber das sind die wichtigsten:

$intent = !empty($data) ? $data : 'default';
$intentData = !empty($data) ? $data : 'default';
$sessionId =  !empty($data) ? $data : 'default';
$logger->info( var_export($data, true));
$logger->info( $intentData );
$logger->info( $sessionId);

Über die Variable $intent finden wir heraus, welcher Intent angesprochen wurde. Per switch-Anweisung gebe ich beim Intent „Hallo“ ein freundliches Hallo zurück. Wurde ein Name mitgegeben, gebe ich ihn ebenfalls zurück. Das Ganze geht als JSON-kodierter String an Alexa zurück.

switch ($intent) {
	// Hallo Intent für Utterances hi, hallo, moin
	case 'hallo':
		// Hallo Intentdata abfragen
		$name = !empty($intentData) ? $intentData : '';
		// save $name in data file - here also mysql can be used
		// later you can use session id to get data like name
		if(!empty($name)) {
			$dataToSave = array($sessionId => array(
				'name' => $name
			));
			$fp = fopen('data.json', 'w');
			fwrite($fp, json_encode($dataToSave));
			fclose($fp);
		}
		$responseArray = ,
		          'shouldEndSession' => false
		    ]
		];
		break;
	// Default
	default:
		$responseArray = ,
		          'shouldEndSession' => true
		    ]
		];
		break;
}
header ( 'Content-Type: application/json' );
echo json_encode ( $responseArray );
die();

Skill testing

Testen können wir unseren Skill mit „Frage daniel Hallo klaus“. Klingt seltsam, aber „frage daniel“ startet den Skill (Aufrufname) und „Hallo“ (Intent) wird ausgeführt. Zum Testen können Sie auch die Alexa-App auf Ihrem Smartphone verwenden.

Fragen & Antworten (4)

  1. Marcon27. Oktober 2019

    I can create a skill for check status in my server, but in Validation retorn this errors.
    https://i.imgur.com/6dqOI22.png

  2. Diego17. September 2019

    Hi, Please, I can’t follow this tutorial. I want to mount the endpoint on a php web server, but I have no clear the folders and files I must to have. Please can you help me?

    Entschuldigen Sie mein schlechtes Englisch 🙁

  3. ankit25. August 2019

    hey daniel,
    i just read your post about alexa skill with php.
    i just want to know that it is possible to integrate MySQL database with the help PHP and alexa

  4. Eugene van der Merwe27. Juli 2019

    This works really well!

    just 2 things:

    1.Formatting of code where you include monolog.
    2. Skill testing: Use “Ask” not “Question” daniel hello klaus

Weitere Artikel

Alle Artikel →
Allgemein17. November 2026 KI-Bilder kennzeichnen: Was seit dem AI Act gilt Produktbilder aus dem Bildgenerator, Kampagnenmotive mit KI, ein Model, das es gar nicht gibt: KI-Bilder sind in Onlineshops und auf Websites längst Alltag. Seit dem 2. August 2026… Allgemein10. November 2026 PlentyONE & Claude: KI-Antwortentwürfe im Messenger „Wo ist meine Bestellung?“, „Wann wird versendet?“, „Mein Gutschein funktioniert nicht“: Im Kundenservice eines Onlineshops wiederholen sich viele Fragen. Wer mit PlentyONE (früher… Allgemein29. Oktober 2026 EU AI Act: Was die KI-Verordnung für Websites und Online-Shops bedeutet Seit dem 2. August 2026 gelten die Transparenzpflichten der europäischen KI-Verordnung, des EU AI Act. Wer auf seiner Website einen KI-Chatbot einsetzt, Bilder mit KI erzeugt oder …

Steigern wir Ihren Online-Umsatz.

Erzählen Sie uns von Ihrem Shop oder Ihrer Website. Es antwortet ein Entwickler, kein Vertrieb.

★ 4,85/5 aus 800+ Bewertungen · Envato Elite Author · Made in Germany