botfire

botfire

ดูเวอร์ชันใหม่ของไลบรารีนี้ที่นี่

สร้างหุ่นยนต์ด้วยโค้ดสามบรรทัด :)

bot:: setToken ( ' token-string ' );
bot:: autoInput ();

bot:: id (chat_id)-> message ( ' hello my robot ' )-> send ();

• การใช้งานขั้นพื้นฐาน
• รับฉัน

เว็บฮุค

• ตั้งค่าWebhook
• getWebhookInfo

วิธีการส่ง

• ส่งข้อความ
• ส่งรูปภาพ
• ส่งเสียง
• ส่งเอกสาร
• ส่งวิดีโอ
• ส่งภาพเคลื่อนไหว
• ส่งเสียง
• ส่งวิดีโอหมายเหตุ
• ส่งตำแหน่ง
• sendMediaGroup

วิธีการอัพเดต

• แก้ไขข้อความข้อความ
• แก้ไขข้อความคำอธิบายภาพ
• แก้ไข MessageReplyMarkup
• ลบข้อความ

วิธีการเป็นสมาชิกแชท

• รับแชท
• getChatAdministrators
• getChatMembersCount

แป้นพิมพ์

• แป้นพิมพ์อินไลน์
• แป้นพิมพ์มาร์กอัป

การใช้งาน

การใช้งานในกรอบเวลากลางคืน

 use Models  botfire as bot ;

หรือนำไปใช้ในโครงการอื่น ( ดูตัวอย่าง )

botfire.php'); use Models botfire as bot;">

 include_once ( ' botfire .php ' );
use Models  botfire as bot ;

การใช้งานขั้นพื้นฐาน

bot:: setToken ( ' token-string ' );
bot:: autoInput ();

ดาวน์โหลดและแตก botfire .php ไปยังไดเร็กทอรี models :|

รับฉัน

 $ res =bot:: this ()-> getMe ()-> send ();
echo $ res ;

ส่งข้อความ

ใช้วิธีนี้เพื่อส่งข้อความ เมื่อสำเร็จ ข้อความที่ส่งจะถูกส่งกลับ

botfire_keyboard) ->disable_web_page_preview(boolean) ->send();">

bot:: id (chat_id)
-> message ( ' text ' )
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> disable_web_page_preview (boolean)
-> send ();

รหัสตัวอย่าง

bot:: id (chat_id)-> message ( ' your message text ' )-> send ();

bot:: id (chat_id)-> message ( ' use <b> parse_mode <b> ' )-> parse_mode ( ' HTML ' )-> send ();

ใช้วิธีการอื่น

ส่งรูปภาพ

ใช้วิธีนี้ในการส่งภาพถ่าย เมื่อสำเร็จ ข้อความที่ส่งจะถูกส่งกลับ

botfire_keyboard) ->send();">

bot:: id (chat_id)
-> photo ( $ file , ' Caption ' )
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

รหัสตัวอย่าง

 // send from url
bot:: id (chat_id)-> photo (image_url_string)-> send ();

// send by file_id
bot:: id (chat_id)-> photo (file_id_string)-> send ();

// send file from local server
$ file =bot:: loadFile ( ' user.png ' );
bot:: id (chat_id)-> photo ( $ file )-> send ();

// send photo with caption
bot:: id (chat_id)-> photo ( $ file , ' Caption ' )-> send ();

ส่งเสียง

ใช้วิธีนี้ในการส่งเสียง เสียงของเราต้องอยู่ในรูปแบบ .MP3 หรือ .M4A

botfire_keyboard) ->send(); ">

bot:: id (chat_id)
-> audio ( $ file , ' Caption text for audio ' )
-> duration (int_to_seconds) //Duration of the audio in seconds
-> performer (string)
-> title (string) //Track name
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

รหัสตัวอย่าง

bot:: id (chat_id)-> audio ( $ file , ' Caption text for audio ' )-> send ();

ส่งเอกสาร

ใช้วิธีนี้เพื่อส่งไฟล์ทั่วไป

botfire_keyboard) ->send(); // example bot::id(file_id)->document( file_id , 'Caption text for document' )->send();">

bot:: id (file_id)
-> document ( $ file , ' Caption text for document ' )
-> thumb (loadFile_or_string)
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

// example
bot:: id (file_id)-> document ( file_id , ' Caption text for document ' )-> send ();

ส่งวิดีโอ

ใช้วิธีนี้เพื่อส่งไฟล์วิดีโอ

botfire_keyboard) ->send(); // example bot::id(file_id)->video( $file , 'Caption text for video' )->send(); ">

bot:: id (file_id)
-> video ( $ file , ' Caption text for video ' )
-> duration (int_to_seconds) //Duration of sent video in seconds
-> width (int) //Animation width
-> height (int) //Animation height
-> thumb (loadFile_or_string)
-> parse_mode (string) // HTML or Markdown
-> supports_streaming (boolean) //Pass True, if the uploaded video is suitable for streaming
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

// example
bot:: id (file_id)-> video ( $ file , ' Caption text for video ' )-> send ();

ส่งภาพเคลื่อนไหว

ใช้วิธีนี้เพื่อส่งไฟล์ภาพเคลื่อนไหว (วิดีโอ GIF หรือ H.264/MPEG-4 AVC โดยไม่มีเสียง)

botfire_keyboard) ->send();">

bot:: this ()-> animation ( $ file , ' Caption text for animation ' )-> send ();

// use other methods
bot:: this ()
-> animation ( $ file , ' Caption text for animation ' )
-> duration (int_to_seconds) //Duration of sent animation in seconds
-> width (int) //Animation width
-> height (int) //Animation height
-> thumb (loadFile_or_string)
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

ส่งเสียง

ใช้วิธีนี้เพื่อส่งเสียง

botfire_keyboard) ->send();">

bot:: this ()-> voice ( $ file , ' Caption text for voice ' )-> send ();

// use other methods
bot:: this ()
-> voice ( $ file , ' caption ' )
-> parse_mode (string) // HTML or Markdown
-> duration (int_to_seconds) //Duration of sent voice in seconds
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

ส่งวิดีโอหมายเหตุ

ในเวอร์ชัน 4.0 ไคลเอนต์ Telegram รองรับวิดีโอ mp4 สี่เหลี่ยมจัตุรัสโค้งมนที่มีความยาวสูงสุด 1 นาที

botfire_keyboard) ->send();">

bot:: this ()-> voice ( video_file )-> send ();

// use other methods
bot:: this ()
-> voice ( video_file )
-> duration (int_to_seconds) //Duration of sent video in seconds
-> length (int) //Video width and height
-> thumb (loadFile_or_string)
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

บอท::loadFile

ฟังก์ชัน loadFile ใช้ในการส่งไฟล์เซิร์ฟเวอร์

bot:: this ()-> document (  bot:: loadFile (file_path_string) )-> send ();

ส่งตำแหน่ง

ใช้วิธีนี้เพื่อส่งจุดบนแผนที่ เมื่อสำเร็จ ข้อความที่ส่งจะถูกส่งกลับ

bot:: this ()-> location ( $ latitude , $ longitude )-> send ();

// support live_period
bot:: this ()-> location ( $ latitude , $ longitude )-> live_period ( $ number )-> send ();

ส่งการดำเนินการแชท

ใช้วิธีนี้เมื่อคุณต้องการบอกผู้ใช้ว่ามีบางอย่างเกิดขึ้นที่ฝั่งบอท

รายการการกระทำ:

'กำลังพิมพ์','upload_photo','record_video','upload_video','record_audio','upload_audio','upload_document','find_location','record_video_note','upload_video_note'

bot:: this ()-> chatAction ( ' typing ' )-> send ();

sendMediaGroup

ใช้วิธีนี้เพื่อส่งกลุ่มภาพถ่ายหรือวิดีโอเป็นอัลบั้ม เมื่อสำเร็จ อาร์เรย์ของข้อความที่ส่งจะถูกส่งกลับ

อินพุตมีเดียรูปภาพ

bot:: id (chat_id)
  -> mediaGroup ()
    -> photo (file_id)-> caption ( ' caption ... ' )
    -> photo (other_file_id)
  -> send ();


  // support this methods
  // ..->photo(file_id)
  // ->caption($caption)
  // ->parse_mode('HTML')

อินพุตมีเดียวิดีโอ

bot:: id (chat_id)
  -> mediaGroup ()
    -> video (file_id)-> caption ( ' caption ... ' )
    -> video (other_file_id)
  -> send ();

  // support this methods
  // ..->video(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')
  // ->width($width)
  // ->height($height)
  // ->duration($duration)
  // ->supports_streaming($supports_streaming)

อินพุทมีเดียแอนิเมชั่น

bot:: id (chat_id)
  -> mediaGroup ()
    -> animation (file_id)-> caption ( ' caption ... ' )
    -> animation (other_file_id)
  -> send ();

  // support this methods
  // ..->animation(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')
  // ->width($width)
  // ->height($height)
  // ->duration($duration)

อินพุทมีเดียออดิโอ

bot:: id (chat_id)
  -> mediaGroup ()
    -> audio (file_id)-> caption ( ' caption ... ' )
    -> audio (other_file_id)
  -> send ();

  // support this methods
  // ..->audio(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')
  // ->duration($duration)
  // ->performer($performer)
  // ->title($title)

เอกสารอินพุตมีเดีย

bot:: id (chat_id)
  -> mediaGroup ()
    -> document (file_id)-> caption ( ' caption ... ' )
    -> document (other_file_id)
  -> send ();

  // support this methods
  // ..->document(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')

### ตัวอย่างแป้นพิมพ์แบบอินไลน์ของแป้นพิมพ์:

 $ k =bot:: keyboard ();

$ k -> inline ()-> row ( function ( $ col ){
  // usage callback
  $ col -> btn ( ' button name ' , ' callback_text ' );

  // usage url
  $ col -> btnUrl ( ' night framework ' , ' https://nightframework.com ' );
})
-> row ( function ( $ col ){
  $ col -> btn ( ' one button ' , ' callback_text_2 ' );
});

// send message with inline button
bot:: this ()-> message ( ' message text ' )-> keyboard ( $ k )-> send ();

// send photo with inline button
bot:: this ()-> photo (file_id, ' caption ' )-> keyboard ( $ k )-> send ();

ตัวอย่างที่ 2

 $ k =bot:: keyboard ();
$ k -> btn ( ' game 1 ' , ' game_callback ' );
$ k -> btn ( ' game 2 ' , ' game_callback ' );
$ k -> row ();

bot:: this ()-> message ( ' message text ' )-> keyboard ( $ k )-> send ();

โทรเลขตอบกลับKeyboardMarkup Docs

มาร์กอัป($resize_keyboard,$one_time_keyboard,$selective)

 $ k =bot:: keyboard ();

$ k -> markup ()-> row ( function ( $ col ){
  $ col -> btn ( ' button name ' );
});

$ k -> markup ( true )-> row ( function ( $ col ){
  $ col -> btn ( ' button name ' );
});

bot:: this ()-> message ( ' text ' )-> keyboard ( $ k )-> send ();

ลบคีย์บอร์ดมาร์กอัป

bot:: this ()-> message ( ' text ' )-> removeKeyboard ()-> send ();

สอบถามโทรกลับ

ตรวจสอบคำขอ calback

 if (bot:: $ isCallback ){
    /// code ..
}

รับข้อมูลการโทรกลับ

 $ data =bot:: get ( ' data ' );

รับ callback_query_id

 $ query_id = bot:: get ( ' callback_id ' );

answerCallback($show_alert=false)

bot:: this ()-> answerCallback ()-> send ();

// send alert
bot:: this ()-> answerCallback ( true )-> text ( ' hello Telegram :) ' )-> send ();

// or open robot link
$ link = ' t.me/your_robot?start=xxxx ' ;
bot:: this ()-> answerCallback ()-> url ( $ link )-> send ();

แก้ไขข้อความ

แก้ไขข้อความข้อความ

ใช้วิธีนี้เพื่อแก้ไขข้อความและข้อความในเกม เมื่อสำเร็จ หากบอทส่งข้อความที่แก้ไขแล้ว ข้อความที่แก้ไขจะถูกส่งกลับ มิฉะนั้นจะส่งคืน True

bot:: this ()-> editMessage ( ' new text string ' )-> send ();

 // use other methods
bot:: this ()
-> editMessage ( ' new text string ' )

// Use custom message_id
-> message_id (id)
// Use custom inline_message_id
-> inline_message_id (id)

-> parse_mode ( ' HTML ' )
-> disable_web_page_preview (boolean)
-> keyboard ( $ k ) // A JSON-serialized object for an inline keyboard.
-> send ();

แก้ไขข้อความคำอธิบายภาพ

ใช้วิธีนี้เพื่อแก้ไขคำอธิบายข้อความ เมื่อสำเร็จ หากบอทส่งข้อความที่แก้ไขแล้ว ข้อความที่แก้ไขจะถูกส่งกลับ มิฉะนั้นจะส่งคืน True

bot:: this ()-> editCaption ( ' new text string ' )-> send ();

 // use other methods
bot:: this ()
-> editCaption ( ' new text string ' )

// Use custom message_id
-> message_id (id)
// Use custom inline_message_id
-> inline_message_id (id)

-> parse_mode ( ' HTML ' )
-> keyboard ( $ k ) // A JSON-serialized object for an inline keyboard.
-> send ();

แก้ไข MessageReplyMarkup

ใช้วิธีนี้เพื่อแก้ไขเฉพาะมาร์กอัปตอบกลับของข้อความ เมื่อสำเร็จ หากบอทส่งข้อความที่แก้ไขแล้ว ข้อความที่แก้ไขจะถูกส่งกลับ มิฉะนั้นจะส่งคืน True

bot:: this ()-> editReplyMarkup ()-> keyboard ( $ k )-> send ();

 // use other methods
bot:: this ()
-> editReplyMarkup ( ' new text string ' )

// Use custom message_id
-> message_id (id)
// Use custom inline_message_id
-> inline_message_id (id)

-> keyboard ( $ k ) // A JSON-serialized object for an inline keyboard.
-> send ();

ลบข้อความ

ใช้วิธีนี้เพื่อลบข้อความ

bot:: this ()-> deleteMessage ()-> send ();
// or
bot:: this ()-> deleteMessage ()-> message_id ( ' custom message_id ' )-> send ();

ตั้งค่าWebhook

bot:: this ()-> setWebhook ( $ url )-> send ();

// or

bot:: this ()-> setWebhook ( $ url )-> max_connections ( 40 )-> send ();

// or

$ cert =bot:: loadFile ( ' certificate.txt ' );

bot:: this ()
-> setWebhook ( $ url )
-> certificate ( $ cert )
-> allowed_updates ( $ array )
-> send ();

getWebhookInfo

 $ res =bot:: this ()-> getWebhookInfo ()-> send ();
echo $ res ;

---

สมาชิก

รับแชท

ใช้วิธีนี้เพื่อรับข้อมูลล่าสุดเกี่ยวกับการแชท (ชื่อปัจจุบันของผู้ใช้สำหรับการสนทนาแบบตัวต่อตัว ชื่อผู้ใช้ปัจจุบันของผู้ใช้ กลุ่มหรือช่อง ฯลฯ) ส่งคืนออบเจ็กต์ Chat เมื่อสำเร็จ

 $ result =bot:: this ()-> getChat ()-> send ();
// or
$ result =bot:: id (chat_id)-> getChat ()-> send ();

echo $ result ;

getChatAdministrators

ใช้วิธีนี้เพื่อรับรายชื่อผู้ดูแลระบบในการแชท เมื่อสำเร็จ จะส่งคืนออบเจ็กต์ Array of ChatMember ที่มีข้อมูลเกี่ยวกับผู้ดูแลระบบแชททั้งหมด ยกเว้นบอทอื่นๆ หากแชทเป็นกลุ่มหรือซูเปอร์กรุ๊ปและไม่มีการแต่งตั้งผู้ดูแลระบบ จะมีเพียงผู้สร้างเท่านั้นที่จะถูกส่งกลับ

 $ result =bot:: this ()-> getChatAdministrators ()-> send ();
// or
$ result =bot:: id (chat_id)-> getChatAdministrators ()-> send ();

echo $ result ;

getChatMembersCount

ใช้วิธีนี้เพื่อรับจำนวนสมาชิกในการแชท ส่งคืน Int เมื่อสำเร็จ

 $ result =bot:: this ()-> getChatMembersCount ()-> send ();
// or
$ result =bot:: id (chat_id)-> getChatMembersCount ()-> send ();

echo $ result ;

---

การเข้าถึงข้อมูล

 // Get the current chat_id
$ chat_id =bot:: $ chat_id ;

// Get the current username
$ username =bot:: $ username ;

// Get the current first_name
$ first_name =bot:: $ first_name ;

// Get the current last_name
$ last_name =bot:: $ last_name ;

// first_name + last_name
$ full_name =bot:: $ full_name ;

//Receive text the user has sent
$ text =bot:: get ( ' text ' );

// get message_id
$ message_id =bot:: get ( ' message_id ' );

// get message caption
$ caption =bot:: get ( ' caption ' );

//Receive object of string sent by telegram
$ ob_str =bot:: $ input ;

//Receive json object sent by telegram
$ json ==bot:: $ json ;

---

ตรวจสอบประเภทลูกค้า

 // If the request is from the supergroup return true else false
$ is_group =bot:: isGroup ();

// If the request is from the supergroup or group return true else false
$ is_group =bot:: isGroup ( false );

// If the request is from the private user
$ is_user =bot:: isUser ();

รับคำขอจากซุปเปอร์กรุ๊ป

 // get group id
$ chat_id = bot:: $ chat_id ;

// Get the group title
$ title = bot:: $ title ;

// get sender user
$ user = bot:: get ( ' user ' );

$ user_chat_id = $ user -> id ;
$ is_bot = $ user -> is_bot ;

พิเศษ

รับประเภทข้อความ (ใหม่)

 // support messages [text,photo,video,video_note,voice,animation,document,contact,location]
$ message = bot:: getMessageType ();

ตัวอย่างข้อความเอาต์พุต:

botfire" }">

{
  "type" : " text " ,
  "data" : " Hello botfire "
}

ตัวอย่างภาพถ่ายที่ส่งออก:

{
  "type" : " photo " ,
  "data" : [
    {
      "file_id" : " AgA*** " ,
      "file_unique_id" : " AQA*** " ,
      "file_size" : 20303 ,
      "width" : 320 ,
      "height" : 296
    }
  ]
}