🛒 Step 1 – Buy Numbers & Set Up Forwarding

To start tracking calls:

1. Buy phone numbers from the Callr Portal.
2. Create a Callr Actions scenario using dial@v1 to forward incoming calls to a destination number.
3. Each purchased number can represent a different source (e.g., website, ad, sales rep).

description: Transparent Call Forwarding

defaults:
  autoAnswer: false

branches:
  inbound-call:
    actions:
      - action: dial@v1
        params:
          targets: 
            - target: "+33199001020" # Your real destination number
              timeout: 60

👍

This setup allows you to trace exactly where the call originated based on the number dialed.

🧪 Step 2 – Test in Build Mode

If your account is in Build Mode:

• You cannot purchase phone numbers.
• Instead, you can assign temporary test numbers to your scenario and simulate inbound scenarios.
• These numbers behave just like real ones, but are only active during testing sessions.
• You can only call real destination numbers you own and have verified. Make sure to add your personal number as a Testing Number in the Callr Portal.

Go to your action in the Portal, click Test, and assign a temporary number to try it out.

🌐 Step 3 – Send Call Data to Your Server

To track and analyze calls, use the fetch@v2 action in the hangup branch to send metadata to your backend:

branches:
  hangup:
    actions:
      - action: fetch@v2
        params:
          url: https://your-server.com/call-logs
          method: POST
          headers:
            content-type: application/json
          body: |
            {
              "run": ${{ JSON.stringify(run) }},
              "call": ${{ JSON.stringify(call) }},
              "scenario": ${{ JSON.stringify(scenario) }}
            }

You’ll receive the full CDR (Call Detail Record), which includes timestamps, duration, numbers, and billing information.

run, call, and scenario are pre-defined variables. The CDR object is fully documented here.

💪 Optional: Step 4 – Level Up Your Call Flow

In Step 1, you created a Transparent Call Forwarding flow — but that’s just the beginning.

With Callr Actions, you can turn a simple redirect into a fully-featured voice experience:

• 👋 Greet the caller with a Text-to-Speech (TTS) message or a pre-recorded audio file
• 🫢 Play a whisper message to the callee (e.g. “This call is from your website”)
• 🔁 Forward to multiple numbers, either sequentially or in parallel
• ⏰ Route calls by context — time of day, caller number, destination number, etc.
• 📬 Take a message with a custom voicemail flow
• 🤖 Use a Multi-Channel AI Agents ✨ to pre-qualify leads or answer questions
• 🧠 Analyze conversations with AI — extract intent, sentiment, and other insights

👍

You can build all of this with just YAML — no servers, no IVR builders, no complex setup.

💡

Did you know?

You can also track calls without buying new numbers by using Click-to-Call — just initiate outbound calls with dial@v1 from your app or CRM, and still capture full call data.