Skip to content

green-api/whatsapp-api-client-python / skills

greenapi-client-python

Verified

Write correct Python code with the official GREEN-API SDK whatsapp-api-client-python (package whatsapp_api_client_python). Use when sending/receiving WhatsApp messages, files, polls, groups, journals, queues, statuses, contacts, partner instances, polling notifications, or configuring a GREEN-API instance in Python. Triggers: GREEN-API, green-api, whatsapp-api-client-python, GreenAPI, GreenApi, sendMessage, receiveNotification.

FileKindSize
SKILL.mdskill md12.9 KB
references/account.mdmarkdown2.9 KB
references/contacts.mdmarkdown796 B
references/device.mdmarkdown346 B
references/groups.mdmarkdown1.9 KB
references/inventory.mdmarkdown12.1 KB
references/journals.mdmarkdown1.1 KB
references/marking.mdmarkdown436 B
references/partner.mdmarkdown930 B
references/queues.mdmarkdown843 B
references/receiving.mdmarkdown4.1 KB
references/sending.mdmarkdown3.7 KB
references/service-methods.mdmarkdown2.0 KB
references/statuses.mdmarkdown1.3 KB

references/account.md

View on GitHub
# Account (`greenAPI.account`)

Class: `Account` in `tools/account.py`.  
Index: https://green-api.com/en/docs/api/account/

## `getSettings` / `setSettings`

- Get: https://green-api.com/en/docs/api/account/GetSettings/
- Set: https://green-api.com/en/docs/api/account/SetSettings/

`setSettings(requestBody: dict)` — pass only fields to change. **Reboots instance**;
settings apply within ~5 minutes. Defaults after create: webhooks off.

Important keys (docs):

| Key | Values / notes |
| --- | --- |
| `webhookUrl` | URL or `""` to disable push / enable polling |
| `webhookUrlToken` | optional auth token for your server |
| `delaySendMessagesMilliseconds` | 500–600000; recommend ≤ 300000 |
| `incomingWebhook` | `yes` / `no` |
| `outgoingWebhook` | `yes` / `no` (statuses) |
| `outgoingMessageWebhook` | phone-sent messages |
| `outgoingAPIMessageWebhook` | API-sent messages |
| `stateWebhook` | auth state changes |
| `incomingCallWebhook` | calls |
| `pollMessageWebhook` | polls |
| `editedMessageWebhook` / `deletedMessageWebhook` | edits/deletes |
| `markIncomingMessagesReaded` | `yes` / `no` |
| `keepOnlineStatus` | keep online when phone off |
| `linkPreview` | `yes` / `no` |
| `autoTyping` | 0–10 typing speed preset |
| `enableLidMode` | work with `@lid` chatIds |

```python
greenAPI.account.setSettings({
    "delaySendMessagesMilliseconds": 5000,
    "incomingWebhook": "yes",
    "webhookUrl": "",
})
```

## `getStateInstance`

Docs: https://green-api.com/en/docs/api/account/GetStateInstance/

Returns `{ "stateInstance": "..." }`:

| State | Meaning |
| --- | --- |
| `authorized` | ready |
| `notAuthorized` | scan QR / auth code |
| `blocked` | banned |
| `starting` | booting (wait) |
| `suspended` | temporary restrictions |
| `sleepMode` | outdated status |
| `yellowCard` | deprecated → use `suspended` |

## `getStatusInstance`

Docs: https://green-api.com/en/docs/api/account/GetStatusInstance/  
Socket connection status with WhatsApp (archive section in docs).

## `getWaSettings`

Docs: https://green-api.com/en/docs/api/account/GetWaSettings/  
WhatsApp account information for the linked number.

## `qr`

Docs: https://green-api.com/en/docs/api/account/QR/  
Returns QR payload for authorization.

## `getAuthorizationCode`

Docs: https://green-api.com/en/docs/api/account/GetAuthorizationCode/  
`phoneNumber: int` — link by phone number (international digits).

## `reboot` / `logout`

- https://green-api.com/en/docs/api/account/Reboot/
- https://green-api.com/en/docs/api/account/Logout/

## `setProfilePicture`

Docs: https://green-api.com/en/docs/api/account/SetProfilePicture/  
SDK: `setProfilePicture(path)` local image path.

## `getStateInstanceHistory`

Docs: https://green-api.com/en/docs/api/account/GetStateInstanceHistory/  
Optional query `count`.

## `updateApiToken`

Docs: https://green-api.com/en/docs/api/account/UpdateApiToken/  
Generates a new `apiTokenInstance` — store the new token after success.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall