name: toingg-create-campaign description: End-to-end Toingg ops: create campaigns, (optionally) schedule daily analytics pulls, and turn Excel contact sheets into WhatsApp outreach via add_contacts + send_whatsapp_templates. Use when Codex needs to automate Toingg voice/WhatsApp workflows and requires scripts for campaign POSTs, analytics cron setup, or bulk contact uploads.

Toingg Ops Toolkit

This skill bundles everything needed to manage Toingg campaigns from Claw:

• Campaign creation via create_campaign.py
• Campaign discovery via fetch_campaigns.py when you need to list active IDs for users
• On-demand calls via make_call.py (after collecting name, phone, and campaign)
• Optional analytics cron (7 PM daily) powered by get_campaign_analytics.py
• Contact upload + WhatsApp broadcast using xlsx_to_contacts.py, add_contacts.py, and send_whatsapp_templates.py

All HTTP calls reuse the TOINGG_API_TOKEN bearer token.

Setup

1. Export your token in every environment that runs these scripts (gateway, cron, terminals).

   export TOINGG_API_TOKEN="tg_..."
   

2. Install Python deps once if you will ingest Excel files:

   pip install openpyxl requests
   

3. Keep payloads (campaign JSON, analytics snapshots, contact exports) in version control or shared storage per your security rules.

Campaign discovery workflow

Use this whenever the user wants to see active campaigns or needs a campaign ID before launching a call.

1. Ask whether they already know the campaign ID. If not, offer to fetch the latest list (default pagination is fine unless they request a different page size).
2. Run:

   ./scripts/fetch_campaigns.py --skip 0 --limit 10 --sort -1 > responses/campaigns-$(date +%s).json
   

   Adjust --skip/--limit/--sort if the user needs deeper pages or a different ordering.
3. Summarize the response back to the user: surface at least campID, name, status, and any relevant dates so they can choose confidently.
4. Store the JSON output when ongoing work depends on the snapshot.

On-demand call workflow

When the user asks you to place a call, gather three pieces of information before touching the API:

1. Caller name (string shown in Toingg logs).
2. Phone number in international format.
3. Campaign selection. If they do not supply a campaign, ask whether they want the latest list. Use the campaign discovery workflow above to provide options, then confirm their pick.

Once those details are confirmed, trigger the API:

./scripts/make_call.py "Recipient Name" +919999999999 64fd3f9...

The helper always sends asr=AZURE, startMessage=true, clearMemory=false, and extraParams={} per the product team’s defaults. Echo the API response (success or failure) back to the user so they know the call status.

Campaign creation workflow