The Unofficial Kik Bot API is a Python library developed to automate interactions on Kik Messenger.
It's essentially a way to create bots that behave like humans on the platform. This library enables your bot to interact with the official Kik app by emulating a real smartphone client. It communicates with Kik's servers at talk1110an.kik.com:5223 over a modified version of the XMPP protocol.
This library is ideal for developers, hobbyists, and businesses who want to build automated bots to interact with users, groups, and other bots on Kik.
We do not endorse the use of this library for spamming or other malicious purposes. Please use this library responsibly.
Make sure you have Python 3.8 or above installed on your system. You can install this library directly from GitHub:
git clone -b new https://github.com/tomer8007/kik-bot-api-unofficial
pip3 install ./kik-bot-api-unofficial
Here's a simple example of how to use the Kik Bot API:
from kik_unofficial.client import KikClient
from kik_unofficial.callbacks import KikClientCallback
import kik_unofficial.datatypes.xmpp.chatting as chatting
from kik_unofficial.datatypes.xmpp.errors import LoginError
# This bot class handles all the callbacks from the kik client
class EchoBot(KikClientCallback):
def __init__(self):
# On initialization, the kik client will attempt to login to kik
self.client = KikClient(self, "your_kik_username", "your_kik_password", enable_console_logging=True)
self.client.wait_for_messages()
# This method is called when the bot receives a direct message from a user
def on_chat_message_received(self, chat_message: chatting.IncomingChatMessage):
self.client.send_chat_message(chat_message.from_jid, f'You said "{chat_message.body}"!')
# This method is called if the login fails for any reason including requiring a captcha
def on_login_error(self, login_error: LoginError):
if login_error.is_captcha():
login_error.solve_captcha_wizard(self.client)
if __name__ == '__main__':
# Creates the bot and start listening for incoming chat messages
callback = EchoBot()
Please replace "your_kik_username" and "your_kik_password" with your actual Kik username and password. You also have to add the bot as a friend on Kik before you can send it messages.
You can find a similar example by running python3 examples/simple_echo_bot.py. Visit the examples directory for more examples.
With the Kik Bot API, you can:
- Log in with kik username and password, retrieve user information (such as email, name, etc).
- Fetch chat partners information
- Send text messages to users/groups and listen for incoming messages
- Send and receive 'is-typing' status
- Send and receive read receipts
- Fetch group information (name, participants, etc.)
- Fetch past message history
- Administer groups (add, remove or ban members, etc)
- Search for groups and join them (experimental feature)
- Receive media content: camera, gallery, stickers
- Add a kik user as a friend
- Send images (including GIFs, using a Tenor API key)
Sending videos or recordings is not supported yet.
Once the bot starts running, you might see a message like this:
To continue, complete the captcha in this URL using a browser: https://captcha.kik.com/?id=...
This means that Kik has detected that you are logging in using a new device and requires you to solve a captcha to continue. You can solve the captcha by opening the URL in a browser and following these steps:
- Press F12 to open the developer tools
- Open the network tab
- Solve the captcha
- Look for a file header that starts with
captcha-url?response=[your captcha response] - Click on it and copy the response from the response tab
- Paste the response in the terminal where the bot is running
After creating a bot, you can bootstrap it to run in a Docker container. This section assumes you have Docker installed on your system.
-
Set up your environment variables. Copy the example file to a new file called
.env:cp .env.example .env
Note: You will need to edit the new
.envfile to include your bot's device ID, android ID, username, password, and JID (if you know it). -
Update the Dockerfile to copy your
bot.pyfile into the container. Change the following line like so:- COPY examples/echo_bot.py /app/bot.py + COPY path/to/your/bot.py /app/bot.py
Note: You can also copy your bot's dependencies into the container by adding a
COPYline for each dependency. -
Deploy the container:
docker compose up --build -d && docker attach kik-bot-api-unofficialNote: You only need to use
--buildwhen you first clone the repo, or if you make changes to the code.
Before investigating the format of certain requests/responses, it's worth checking if they are already documented in the Message Formats page.
If you are on Windows and you are unable to install the lxml package, use the binary installers from PyPi here.
If you are using Termux, then use pkg install libxml2 libxslt to install lxml and pkg install zlib libpng libjpeg-turbo to install pillow dependencies.
For any questions, suggestions, or discussions about the Kik Bot API, feel free to open an issue on the GitHub repository.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent