Descarga botfire - Descarga del código fuente botfire

botfire

️ Vea la nueva versión de esta biblioteca aquí

Construye un robot con tres líneas de código :)

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

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

uso básico
Consígueme

gancho web

establecerWebhook
obtener información webhook

método de envío

enviar mensaje
enviar foto
enviarAudio
enviarDocumento
enviarVideo
enviarAnimación
enviarVoz
enviarVideoNota
enviarUbicación
enviarGrupo de Medios

método de actualización

editarTextoMensaje
editarMensajeCaption
editarMensajeRespuestaMarcar
eliminar mensaje

método de miembro del chat

obtenerChat
getChatAdministradores
getChatMembersCount

teclado

teclado en línea
teclado de marcado

uso

uso en marco nocturno

 use Models  botfire as bot ;

o uso en otro proyecto (ver muestra)

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

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

uso básico

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

descargue y extraiga botfire .php al directorio de modelos :|

Consígueme

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

enviar mensaje

Utilice este método para enviar mensajes de texto. En caso de éxito, se devuelve el mensaje enviado.

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 ();

código de ejemplo

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

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

utilizar otros métodos

enviar foto

Utilice este método para enviar fotografías. En caso de éxito, se devuelve el mensaje enviado.

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 ();

código de ejemplo

 // 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 ();

enviarAudio

Utilice este método para enviar audio; nuestro audio debe estar en formato .MP3 o .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 ();

código de ejemplo

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

enviarDocumento

Utilice este método para enviar archivos generales

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 ();

enviarVideo

Utilice este método para enviar archivos de vídeo

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 ();

enviarAnimación

Utilice este método para enviar archivos de animación (vídeo GIF o H.264/MPEG-4 AVC sin sonido).

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 ();

enviarVoz

Utilice este método para enviar audio

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 ();

enviarVideoNota

A partir de la versión 4.0, los clientes de Telegram admiten vídeos mp4 cuadrados redondeados de hasta 1 minuto de duración.

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 ();

bot::cargararchivo

La función loadFile se utiliza para enviar archivos del servidor.

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

enviarUbicación

Utilice este método para enviar puntos en el mapa. En caso de éxito, se devuelve el mensaje enviado.

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

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

enviar acción de chat

Utilice este método cuando necesite decirle al usuario que algo está sucediendo en el lado del bot.

lista de acciones:

'escribiendo','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 ();

enviarGrupo de Medios

Utilice este método para enviar un grupo de fotos o vídeos como un álbum. En caso de éxito, se devuelve una serie de mensajes enviados.

EntradaMediaFoto

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')

EntradaMediaVídeo

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)

Animación de medios de entrada

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)

EntradaMediaAudio

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)

Documento de medios de entrada

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')

### Ejemplo de teclado en línea:

 $ 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 ();

muestra 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 ();

Documentos de marcado de teclado de respuesta de Telegram

marcado($resize_keyboard,$one_time_keyboard,$selectivo)

 $ 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 ();

eliminar teclado de marcado

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

devolución de llamada de consulta

comprobar solicitud de devolución de llamada

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

Recibir datos de devolución de llamada

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

Recibir callback_query_id

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

responderDevolución de llamada($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 ();

Editar mensaje

editarTextoMensaje

Utilice este método para editar mensajes de texto y de juegos. En caso de éxito, si el bot envía el mensaje editado, se devuelve el mensaje editado; de lo contrario, se devuelve 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 ();

editarMensajeCaption

Utilice este método para editar subtítulos de mensajes. En caso de éxito, si el bot envía el mensaje editado, se devuelve el mensaje editado; de lo contrario, se devuelve 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 ();

editarMensajeRespuestaMarcar

Utilice este método para editar solo el marcado de respuesta de los mensajes. En caso de éxito, si el bot envía el mensaje editado, se devuelve el mensaje editado; de lo contrario, se devuelve 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 ();

eliminar mensaje

Utilice este método para eliminar un mensaje

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

establecerWebhook

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 ();

obtener información webhook

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

Miembros

obtenerChat

Utilice este método para obtener información actualizada sobre el chat (nombre actual del usuario para conversaciones individuales, nombre de usuario actual de un usuario, grupo o canal, etc.). Devuelve un objeto Chat en caso de éxito.

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

echo $ result ;

getChatAdministradores

Utilice este método para obtener una lista de administradores en un chat. En caso de éxito, devuelve una matriz de objetos ChatMember que contiene información sobre todos los administradores de chat excepto otros bots. Si el chat es de grupo o supergrupo y no se nombraron administradores, solo se devolverá el creador.

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

echo $ result ;

getChatMembersCount

Utilice este método para obtener la cantidad de miembros en un chat. Devuelve Int en caso de éxito.

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

echo $ result ;

acceso a datos

 // 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 ;

comprobar tipo de cliente

 // 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 ();

obtener solicitud del supergrupo

 // 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 ;

extra

Obtener tipo de mensaje (nuevo)

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

muestra de texto de salida:

botfire" }">

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

muestra de foto de salida:

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

Expandir