[BUG] Implementation of server-side conversations can be tricky.

[zoltes]

[BUG] Implementation of server-side conversations can be tricky.

[Lukasss93]

Released Nutgram https://github.com/nutgram/nutgram/releases/tag/4.20.0

You will need to use the $this->getChatId() method if you want to use manual methods (sendMessage, etc...) in the first step of the conversation.

To make a conversation work server-side, see these examples:

Conversation

class BaseConversation extends Conversation
{
    public function start(Nutgram $bot): void
    {
        $bot->sendMessage(
            text: 'What is your name?',
            chat_id: $this->getChatId(), // <--
        );
        $this->next('getName');
    }
    
    public function getName(Nutgram $bot): void
    {
        $name = $bot->message()?->text ?? 'unknown';
        $bot->sendMessage("Hello, $name!");
        $this->end();
    }
}

InlineMenu

class MenuConversation extends InlineMenu
{
    public function start(Nutgram $bot): void
    {
        $bot->sendMessage(
            text: 'Starting...',
            chat_id: $this->getChatId(), // <--
        );
        
        $this->menuText('Message')
            ->addButtonRow(InlineKeyboardButton::make('Say hello', callback_data: "@hello"))
            ->addButtonRow(InlineKeyboardButton::make('Close', callback_data: "@end"))
            ->showMenu();
    }
    
    public function hello(Nutgram $bot): void
    {
        $bot->sendMessage('Hello');
        $this->end();
    }
}

[Lukasss93]

Hi, thanks for the feedback.
To make a conversation work server-side, see these examples:

Conversation

class BaseConversation extends Conversation
{
    public function start(Nutgram $bot): void
    {
        //when a server-side conversation is started,
        //the chatId parameter is not automatically filled by Nutgram
        //because we are not in an Update context.
        
        $bot->sendMessage(
            text: 'What is your name?',
            chat_id: $this->getChatId(), //so we need to set the chatId manually (only for this first step)
        );
        
        $this->next('getName');
    }
    
    public function getName(Nutgram $bot): void
    {
        $name = $bot->message()?->text ?? 'unknown';
        
        $bot->sendMessage("Hello, $name!");
        
        $this->end();
    }
}

InlineMenu

class MenuConversation extends InlineMenu
{
    protected function doOpen(string $text, InlineKeyboardMarkup $buttons, array $opt): Message|null
    {
        //we need to override this method to set the chatId manually
        
        return $this->bot->sendMessage(...[
            'reply_markup' => $buttons,
            'text' => $text,
            'chat_id' => $this->chatId, //required for the first step
            ...$opt,
        ]);
    }
    
    public function start(Nutgram $bot): void
    {
        //when a server-side conversation is started,
        //the chatId parameter is not automatically filled by Nutgram
        //because we are not in an Update context.
        
        $this->chatId = $this->getChatId(); //so we need to set the chatId manually (only for this first step)
        
        $this->menuText('Message')
            ->addButtonRow(InlineKeyboardButton::make('Say hello', callback_data: "@hello"))
            ->addButtonRow(InlineKeyboardButton::make('Close', callback_data: "@end"))
            ->showMenu();
    }
    
    public function hello(Nutgram $bot): void
    {
        $bot->sendMessage('Hello');
        $this->end();
    }
    
    public function closing(Nutgram $bot): void
    {
        $bot->sendMessage('Bye!');
        parent::closing($bot);
    }
}

Small note

I know it is a bit confusing to make conversations work server-side. We will try to improve it.