FarolAI
PRACTICAL GUIDE · 7 min read

How to add AI agents to FarolAI and use them on WhatsApp

Turn a message into a request for the right agent. This guide walks you through creating an agent in FarolAI, granting your team access and starting a conversation on WhatsApp. Dashboard labels are included in Portuguese so you can find each setting.

What you need before you start

Create an account on farolai.co. Owners and administrators can create agents; the owner selects the business channel. Running agents requires an active trial or plan and an integrated channel ready to receive messages.

The business channel is the number that receives requests. Your personal or work number is an authorized sender. These are separate settings: choosing a channel does not automatically authorize senders.

1. Create or import your agent

Open Agentes (Agents) and select Criar agente (Create agent). Write your own instructions or chat with GPT to prepare a configuration, then review it before saving.

Enter a name, short description, instructions and Comando no WhatsApp (WhatsApp command). For a marketing assistant, enter marketing without a slash. In a conversation, call it with /marketing. Use lowercase letters, numbers or hyphens, starting with a letter.

To reuse a configuration, select Importar (Import) and upload its JSON file. A private GPT link does not automatically import an agent. After importing, review access and reconnect any required skills and connections.

2. Give the agent clear instructions

Define the goal, audience, tone and boundaries. Explain what the agent should ask when information is missing. Start with this example:

You are our store’s marketing assistant. Write short, friendly copy in English. Before drafting a promotion, ask for the product, audience, price and deadline. Do not invent discounts, stock availability or terms. Return three drafts for review.

Use Skills for reusable instructions such as your brand voice or company processes, then attach them to the agent. Instructions alone do not grant access to external systems: that requires a supported connection and tool.

3. Choose who can use it

Under Quem pode acessar? (Who can access?), select Toda a equipe (global na empresa) (Everyone in the company) or Somente pessoas selecionadas (Selected people only). Global means available within your company, not publicly accessible on the internet.

Add employees in Equipe e acessos (Team and access) and grant the agents each role needs. Owners and administrators can access and manage agents. If you attach a connection, authorized agent users can query the data that connection makes available.

4. Set up your WhatsApp channel

As the owner, open WhatsApp e canais (WhatsApp and channels). Choose a business number supplied by the platform or provide your company’s business number, depending on the available options.

If you provide your own number, follow its preparation status. Entering a number does not activate it immediately: the platform team handles the integration. Wait until the channel is ready before testing.

You do not need to create tokens, configure webhooks or connect a Meta account in the customer dashboard. The platform handles those operational steps.

5. Authorize your team’s sender numbers

Each person opens WhatsApp e canais and registers the number they will send commands from, including country and area codes. Administrators can also register employee numbers in Equipe e acessos.

A user can have multiple authorized numbers, but each number identifies one user. Revoke old numbers and deactivate accounts when people leave your team.

6. Send your first message and check the history

From an authorized number, send /ajuda to the business channel. Keep this command in Portuguese: it lists the agents available to you. Then try:

/marketing Write three post ideas introducing our store’s new collection. Audience: local customers. Tone: friendly. Do not include prices.

Read the reply and check Histórico (History) in the dashboard. Employees see their own requests; administrators can review the team’s requests. Review drafts before sharing them with customers.

What should you check if there is no reply?

  • Is the business channel ready, and did you message the correct number?
  • Is the sender authorized with the correct country and area codes?
  • Does the agent appear in /ajuda, and does your user have access?
  • Does your command match the command saved in the agent?
  • Is your trial or plan active, and are you within the service limits?

If these settings are correct, check the history and ask the platform team for help. A channel still being prepared must finish integration before it can work.

Frequently asked questions

Can I keep using my normal WhatsApp app?

Yes. Send messages from your existing app and authorized number to the configured business channel.

Can any customer talk to my agents?

This workflow is for your company’s authorized users and numbers. Adding a channel does not automatically enable public customer support.

Do I need to code?

No coding is required to create agents and manage access in the dashboard. The platform handles the operational WhatsApp integration.

PUT IT INTO PRACTICE

Start with your first agent.

Give your team a new way to handle everyday tasks.

Create an account ↗