Meta Ads

Here is everything the skill can do for your business right now, in plain terms:

• See your ad accounts. It lists the Meta ad accounts your token can reach, with each account's name, currency, and whether it is active, so you (or the agent) can pick the right one to report on.
• List your campaigns. It pulls the campaigns inside an ad account together with their status (active or paused), their objective, and their budget.
• Read live performance insights. For a whole account or a single campaign, it reports the core numbers: spend, impressions, clicks, CTR (click-through rate), CPC (cost per click), CPM (cost per 1,000 impressions), reach, and frequency. You choose the period, for example today, the last 7 days, the last 30 days, this month, last month, or the account's full history.
• Generate a PDF report. It composes a clean, branded PDF for an ad account over the date range you pick: an account summary at the top, then a per-campaign breakdown sorted by spend. The agent sends it back as a downloadable link you can share as-is.

A few practical notes: money figures come back in the ad account's own currency, and the per-campaign table shows each campaign's spend, impressions, clicks, and CTR so you can see at a glance where the budget is going.

First, add the skill to an agent:

1. Open the Skill Marketplace in your Botonom dashboard and find Meta Ads (category Marketing & Ads).
2. Click Install and choose which of your hired agents should have it, for example your Marketing Agent or Sales Assistant.
3. Add your Meta access token in the skill settings (see the next section).

After that, you talk to the agent in normal language. Some realistic examples:

User: Which of my Meta ad accounts can you see?
Agent: You have access to 2 ad accounts:
       - Acme Store (act_10151772...) - USD, active
       - Acme B2B (act_20337781...) - USD, active
       Which one should I report on?

User: How did our Facebook and Instagram ads do in the last 30 days?
Agent: Over the last 30 days on Acme Store:
       Spend 4,820.00 USD - Impressions 612,400 - Clicks 9,130
       CTR 1.49% - CPC 0.53 USD - Reach 288,010.
       Want me to break it down by campaign or put it in a PDF?

User: Send me a PDF report of last month's campaigns.
Agent: Here is your Meta Ads performance report for last month:
       [downloadable PDF] It covers the account summary plus
       all 7 campaigns, sorted by spend.

Meta Ads is a bring-your-own-token skill. There is no automatic sign-in popup; instead you paste your own Meta access token once, in the skill's settings.

What you need:

• A Meta access token with ads_read. The most reliable choice for a business is a Business Manager System User token, which does not expire the way a personal login does.
• Optionally, a default ad account ID (the number from Ads Manager, for example 10151772278702510). Set this so you do not have to name the account every time you ask a question.

You generate the token inside your own Meta Business settings, then paste it into the Meta Ads skill config in Botonom. The token is stored as a secret (masked and encrypted), and you can replace or remove it at any time to cut off access.

A few honest limits and details so there are no surprises:

• Read-only, for now. The skill reports on your ads. It cannot create campaigns, change budgets, pause ads, or edit anything in your account. Campaign creation and optimization are planned for a later phase.
• Metrics it reports. Spend, impressions, clicks, CTR, CPC, CPM, reach, and frequency. If you need a metric outside that list, it is not available yet through this skill.
• Access is role-gated. Ad performance is business-sensitive, so these tools are restricted to trusted agent roles (staff, manager, admin, owner, and full-access roles). A public or anonymous chat widget cannot pull your ad numbers.
• Your data stays in your workspace. The skill reads directly from Meta using your token and returns the results to your agent. The token is stored encrypted and is never shown back in chat or logs.
• One token, one view. The agent can only see the ad accounts your specific token is permitted to access. If an account is missing, check the permissions on the token in Meta Business settings.