Szybki start
Platforma BotAPI pozwala na szybkie i proste tworzenie botów (takich jak np. Infobot) w sieci Gadu-Gadu. Wystawia zestaw funkcji za pomocą protokołu HTTP, które umożliwiają odbieranie i wysyłanie wiadomości poprzez skrypt/program stworzony przez użytkownika BotAPI.Najważniejsze cechy platformy BotAPI
- odpowiadanie na wiadomości przesłane od użytkownika do bota,
- wysyłanie wiadomości od bota do użytkownika,
- zmiana statusu i opisu bota (w tym możliwość ustawienia opisu graficznego),
- platforma działa w oparciu o kodowanie UTF-8,
- połączenia z platformą mogą być szyfrowane (wsparcie HTTPS).
Co jest potrzebne do stworzenia własnego bota?
Aby uruchomić własnego bota, będziesz potrzebować:- serwer HTTP, na którym umieścisz swój skrypt,
- skrypt wysyłający/odbierający wiadomości zgodnie z protokołem BotAPI,
- numer Gadu-Gadu (wraz z hasłem) pod którym będzie działał bot.
Prosty skrypt bota
Przykładowy, bardzo prosty skrypt bota napisany w języku PHP oraz korzystający z biblioteki BotAPI może wyglądać tak:<?
require_once('MessageBuilder.php');
$M=new MessageBuilder();
switch ($HTTP_RAW_POST_DATA) {
case "cześć": $M->addText('Cześć :)'); break;
case "kim jesteś?": $M->addText('Jestem botem.'); break;
default: $M->addText('Nie rozumiem...');
}
$M->reply();
Pamiętaj o umieszczeniu w katalogu z Twoim skryptem plików biblioteki BotAPI (MessageBuilder.php i PushConnection.php). Bibliotekę możesz pobrać tutaj. Polecamy zapoznanie się z innymi przykładami. Zwróć również uwagę na to, by wszystkie pliki bota były zapisane w kodowaniu UTF-8.