# `bird whatsapp agents`

## Usage

```bash
bird whatsapp agents
```

## Description

An agent belongs to one number, starts off, and answers from its settings, business
info, FAQs, websites, files and skills. Every change applies to the live agent on the
next conversation turn. `test` asks it a question without reaching a contact.

Reads return JSON; list is paginated. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request. Destructive commands require --yes.

## Commands

| Name                                                                 | Description                                                              |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [`allowlist`](/docs/cli/reference/whatsapp-agents-allowlist)         | Choose the contacts an agent answers while its audience is the allowlist |
| [`business-info`](/docs/cli/reference/whatsapp-agents-business-info) | Read and change what an agent knows about the business                   |
| [`create`](/docs/cli/reference/whatsapp-agents-create)               | Onboard an agent on a WhatsApp number                                    |
| [`delete`](/docs/cli/reference/whatsapp-agents-delete)               | Delete a WhatsApp number's agent                                         |
| [`faqs`](/docs/cli/reference/whatsapp-agents-faqs)                   | Manage the questions and answers an agent answers from                   |
| [`files`](/docs/cli/reference/whatsapp-agents-files)                 | Upload, read and remove the documents an agent answers from              |
| [`get`](/docs/cli/reference/whatsapp-agents-get)                     | Get a WhatsApp number's agent                                            |
| [`list`](/docs/cli/reference/whatsapp-agents-list)                   | List WhatsApp numbers with their agent state                             |
| [`notifications`](/docs/cli/reference/whatsapp-agents-notifications) | Tell an agent about something that happened to one contact               |
| [`settings`](/docs/cli/reference/whatsapp-agents-settings)           | Read and change how an agent behaves                                     |
| [`skills`](/docs/cli/reference/whatsapp-agents-skills)               | Manage what an agent does in situations you describe                     |
| [`test`](/docs/cli/reference/whatsapp-agents-test)                   | Send an agent a test message                                             |
| [`ui-skills`](/docs/cli/reference/whatsapp-agents-ui-skills)         | Manage the rich-message components an agent may answer with              |
| [`websites`](/docs/cli/reference/whatsapp-agents-websites)           | Manage the web pages an agent learns from                                |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)