Como adicionar um bot em um aplicativo Android utilizando o BLiP Chat? Blip Help 16 de junho de 2023 23:11 Atualizado Índice: Adicionando referência Pré-requisitos Abrindo sua janela de conversa Customizando a interface do chat no Android (Opcional) Esconder o menu da janela Título da janela Com o BLiP Chat, é possível colocar o seu bot dentro do seu aplicativo Android de forma muito simples. Para isso, adicione a referência do repositório no arquivo build.gradle do seu projeto: Adicionando referência Adicione a referência para o repositório Maven jcenter. Para dúvidas sobre este passo, consulte a documentação oficial: allprojects { repositories { //others repository dependencies mavenCentral() } } E importe o módulo via gradle: implementation 'io.github.takenet:blipchat:2.1.25.2' Ou via Maven: <dependency><groupId>io.github.takenet</groupId><artifactId>blipchat</artifactId><version>2.1.25.2</version><type>pom</type></dependency> Ou faça o download da Maven Repository e importe para o seu app. Pré-requisitos Para poder utilizar o BLiP Chat, seu app deve ter acesso à internet. Tal permissão deve ser requisitada dentro do arquivo AndroidManifest.xml do seu projeto. Se em algum momento o seu chatbot requisita a localização do usuário, você também deve adicionar a permissão de localização. Para enviar arquivos, você também precisará conceder permissões. Para tanto, adicione as informações abaixo no arquivo de manifesto do seu projeto: <manifest xlmns:android...> ... <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.CAMERA" /> ... </manifest> Também será necessário adicionar a dependência GSON ao seu aplicativo, uma vez que o BLiP Chat usa esta biblioteca. implementation 'com.google.code.gson:gson:2.8.9' Abrindo sua janela de conversa Para abrir a janela de conversa com o bot dentro do seu aplicativo, use a classe BlipClient e chame o método openBlipThread, passando seu contexto atual e sua API-KEY. BlipClient.openBlipThread(context, "YOUR-BLiP-CHAT-API-KEY", null); Para encontrar a API-KEY do BLiP Chat do seu bot, vá até o portal e escolha o bot correspondente. Clique no módulo Canais e escolha o canal BLiP Chat. Clique na aba Instalação e copie sua API-KEY, conforme a imagem abaixo: Para encontrar a API-KEY do BLiP Chat do seu bot, vá até o portal e escolha o bot correspondente. Clique no módulo Canais e escolha o canal BLiP Chat. Clique na aba Instalação e copie sua API-KEY, conforme a imagem abaixo: Observação: O método openBlipThread pode retornar uma exceção, já que ele verifica se possui todas as informações necessárias para abrir o chat. Então, você deve colocá-lo dentro de um try catch. Você também pode passar um objeto BlipOptions, que possui algumas configurações opcionais que serão abordadas mais adiante. Exemplo: Imagine que você queira abrir uma conversa entre o usuário e o seu chatbot assim que o app é aberto. public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); try { BlipClient.openBlipThread(context, "SUA-API-KEY", null); } catch (IllegalArgumentException e) { e.printStackTrace(); } } } Customizando a interface do chat no Android (Opcional) Existem algumas possibilidades de customização do seu chat que podem ser configuradas através do objeto BlipOptions. São elas: Autenticação: É possível definir o tipo de autenticação do usuário que irá conversar com o seu chatbot. Existem dois tipos de autenticações possíveis: Não logado: na qual cada usuário é tratado como convidado e não há quaisquer informações sobre ele. Logado: na qual o desenvolvedor do app é responsável por passar as informações do usuário para o BLiP Chat. Nesse modo, o histórico da conversa está disponível sempre que o usuário se conectar. Para entender melhor os possíveis modos de autenticação, veja este post. Exemplo: import net.take.blipchat.AuthType; import net.take.blipchat.BlipClient; import net.take.blipchat.models.AuthConfig; import net.take.blipchat.models.BlipOptions; import org.limeprotocol.messaging.resources.Account; ... AuthConfig authConfig = new AuthConfig(AuthType.Dev, "userId123PS","pass123PS"); Account account = new Account(); account.setFullName("User Name Android123"); account.setEmail("test@android.com"); BlipOptions blipOptions = new BlipOptions(); blipOptions.setAuthConfig(authConfig); blipOptions.setAccount(account); BlipClient.openBlipThread(context, APP_KEY, blipOptions); Esconder o menu da janela A janela de conversa com o seu chatbot possui um menu no canto superior direito que pode ser escondido. Para isso, basta definir o valor para a propriedade hideMenu dentro do objeto BlipOptions. Por padrão, essa propriedade é false. BlipOptions blipOptions = new BlipOptions(); blipOptions.setHideMenu(true); Título da janela No Android, a janela do BLiP Chat possui um título que pode ser customizado. Para isso, defina o valor da propriedade windowTitle com o título apropriado. Por padrão, este título é BLiP Chat. let options = BlipOptions() options.windowTitle = "Seu Título"; Exemplo: import net.blip.blipchat.*; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); try { BlipOptions blipOptions = new BlipOptions(); blipOptions.setAuthType(AuthType.DEV); blipOptions.setUserIdentifier("IDENTIFICADOR-DO-USUARIO"); blipOptions.setUserPassword("SENHA-DO-USUARIO"); blipOptions.setUserName("NOME-DO-USUARIO"); blipOptions.setUserEmail("EMAIL-DO-USUARIO"); blipOptions.setHideMenu(true); // Esconde o menu da janela BlipClient.openBlipThread(MainActivity.this, "SUA-API-KEY", blipOptions); } catch (IllegalArgumentException e) { e.printStackTrace(); } } } Trocar: https://bintray.com/bintray/jcenter https://mvnrepository.com/artifact/io.github.takenet/blipchat implementation 'net.take:blip-chat:2.1.24' implementation 'io.github.takenet:blipchat:2.1.25.2' jcenter() mavenCentral() <dependency> <groupId>net.take</groupId> <artifactId>blip-chat</artifactId> <version>2.1.24</version> <type>pom</type> </dependency> <dependency> <groupId>io.github.takenet</groupId> <artifactId>blipchat</artifactId> <version>2.1.25.2</version> <type>pom</type> </dependency> Link “Ou faça o download da última versão JAR” Maven Repository implementation 'com.google.code.gson:gson:2.8.5' implementation 'com.google.code.gson:gson:2.8.9' Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Como adicionar um bot em um aplicativo iOS utilizando o BLiP Chat? Como adicionar push notification no BLiP Chat Android Envio de Mensagens Ativas do WhatsApp no Blip Desk Como permitir envio de arquivos no Blip Chat Como enviar SMS via API
Índice: Adicionando referência Pré-requisitos Abrindo sua janela de conversa Customizando a interface do chat no Android (Opcional) Esconder o menu da janela Título da janela Com o BLiP Chat, é possível colocar o seu bot dentro do seu aplicativo Android de forma muito simples. Para isso, adicione a referência do repositório no arquivo build.gradle do seu projeto: Adicionando referência Adicione a referência para o repositório Maven jcenter. Para dúvidas sobre este passo, consulte a documentação oficial: allprojects { repositories { //others repository dependencies mavenCentral() } } E importe o módulo via gradle: implementation 'io.github.takenet:blipchat:2.1.25.2' Ou via Maven: <dependency><groupId>io.github.takenet</groupId><artifactId>blipchat</artifactId><version>2.1.25.2</version><type>pom</type></dependency> Ou faça o download da Maven Repository e importe para o seu app. Pré-requisitos Para poder utilizar o BLiP Chat, seu app deve ter acesso à internet. Tal permissão deve ser requisitada dentro do arquivo AndroidManifest.xml do seu projeto. Se em algum momento o seu chatbot requisita a localização do usuário, você também deve adicionar a permissão de localização. Para enviar arquivos, você também precisará conceder permissões. Para tanto, adicione as informações abaixo no arquivo de manifesto do seu projeto: <manifest xlmns:android...> ... <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.CAMERA" /> ... </manifest> Também será necessário adicionar a dependência GSON ao seu aplicativo, uma vez que o BLiP Chat usa esta biblioteca. implementation 'com.google.code.gson:gson:2.8.9' Abrindo sua janela de conversa Para abrir a janela de conversa com o bot dentro do seu aplicativo, use a classe BlipClient e chame o método openBlipThread, passando seu contexto atual e sua API-KEY. BlipClient.openBlipThread(context, "YOUR-BLiP-CHAT-API-KEY", null); Para encontrar a API-KEY do BLiP Chat do seu bot, vá até o portal e escolha o bot correspondente. Clique no módulo Canais e escolha o canal BLiP Chat. Clique na aba Instalação e copie sua API-KEY, conforme a imagem abaixo: Para encontrar a API-KEY do BLiP Chat do seu bot, vá até o portal e escolha o bot correspondente. Clique no módulo Canais e escolha o canal BLiP Chat. Clique na aba Instalação e copie sua API-KEY, conforme a imagem abaixo: Observação: O método openBlipThread pode retornar uma exceção, já que ele verifica se possui todas as informações necessárias para abrir o chat. Então, você deve colocá-lo dentro de um try catch. Você também pode passar um objeto BlipOptions, que possui algumas configurações opcionais que serão abordadas mais adiante. Exemplo: Imagine que você queira abrir uma conversa entre o usuário e o seu chatbot assim que o app é aberto. public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); try { BlipClient.openBlipThread(context, "SUA-API-KEY", null); } catch (IllegalArgumentException e) { e.printStackTrace(); } } } Customizando a interface do chat no Android (Opcional) Existem algumas possibilidades de customização do seu chat que podem ser configuradas através do objeto BlipOptions. São elas: Autenticação: É possível definir o tipo de autenticação do usuário que irá conversar com o seu chatbot. Existem dois tipos de autenticações possíveis: Não logado: na qual cada usuário é tratado como convidado e não há quaisquer informações sobre ele. Logado: na qual o desenvolvedor do app é responsável por passar as informações do usuário para o BLiP Chat. Nesse modo, o histórico da conversa está disponível sempre que o usuário se conectar. Para entender melhor os possíveis modos de autenticação, veja este post. Exemplo: import net.take.blipchat.AuthType; import net.take.blipchat.BlipClient; import net.take.blipchat.models.AuthConfig; import net.take.blipchat.models.BlipOptions; import org.limeprotocol.messaging.resources.Account; ... AuthConfig authConfig = new AuthConfig(AuthType.Dev, "userId123PS","pass123PS"); Account account = new Account(); account.setFullName("User Name Android123"); account.setEmail("test@android.com"); BlipOptions blipOptions = new BlipOptions(); blipOptions.setAuthConfig(authConfig); blipOptions.setAccount(account); BlipClient.openBlipThread(context, APP_KEY, blipOptions); Esconder o menu da janela A janela de conversa com o seu chatbot possui um menu no canto superior direito que pode ser escondido. Para isso, basta definir o valor para a propriedade hideMenu dentro do objeto BlipOptions. Por padrão, essa propriedade é false. BlipOptions blipOptions = new BlipOptions(); blipOptions.setHideMenu(true); Título da janela No Android, a janela do BLiP Chat possui um título que pode ser customizado. Para isso, defina o valor da propriedade windowTitle com o título apropriado. Por padrão, este título é BLiP Chat. let options = BlipOptions() options.windowTitle = "Seu Título"; Exemplo: import net.blip.blipchat.*; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); try { BlipOptions blipOptions = new BlipOptions(); blipOptions.setAuthType(AuthType.DEV); blipOptions.setUserIdentifier("IDENTIFICADOR-DO-USUARIO"); blipOptions.setUserPassword("SENHA-DO-USUARIO"); blipOptions.setUserName("NOME-DO-USUARIO"); blipOptions.setUserEmail("EMAIL-DO-USUARIO"); blipOptions.setHideMenu(true); // Esconde o menu da janela BlipClient.openBlipThread(MainActivity.this, "SUA-API-KEY", blipOptions); } catch (IllegalArgumentException e) { e.printStackTrace(); } } } Trocar: https://bintray.com/bintray/jcenter https://mvnrepository.com/artifact/io.github.takenet/blipchat implementation 'net.take:blip-chat:2.1.24' implementation 'io.github.takenet:blipchat:2.1.25.2' jcenter() mavenCentral() <dependency> <groupId>net.take</groupId> <artifactId>blip-chat</artifactId> <version>2.1.24</version> <type>pom</type> </dependency> <dependency> <groupId>io.github.takenet</groupId> <artifactId>blipchat</artifactId> <version>2.1.25.2</version> <type>pom</type> </dependency> Link “Ou faça o download da última versão JAR” Maven Repository implementation 'com.google.code.gson:gson:2.8.5' implementation 'com.google.code.gson:gson:2.8.9' Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃