Knova Outbound Calling

​

Overview

• Portal test call — trigger a one-off call directly from the Knova Agents page
• Webhook trigger — connect GoHighLevel, n8n, Zapier, or Facebook Lead Ads to fire calls automatically
• Dynamic variables — inject lead name, topic, or any custom value into the agent’s prompt and greeting at runtime

​

Prerequisites

1. You have a Knova agent created and published in the Partner Portal.
2. You have a voice-capable phone number imported (Twilio or Telnyx) — or platform ops has configured the shared Knotie trunk for you.
3. The phone number is assigned to your Knova agent (see Step 1 below).

​

Step 1 — Assign a phone number to your Knova agent

1. In the Partner Portal, go to Phone Numbers.
2. Find the number you want to use for outbound calls.
3. Open the actions menu and click Assign Agent.
4. Select your Knova agent from the list and click Save.

​

Step 2 — Run a test call from the portal

1. In the Partner Portal, go to AI Agents → Knova Agents.
2. Open the three-dot menu on your agent and click Test Outbound Call.
3. In the modal:
   • Enter the destination number (E.164 format, e.g. +14155551212) — use your own mobile first.
   • Optionally add dynamic variables — key/value pairs that replace {{key}} placeholders in the agent’s prompt and greeting (e.g. lead_name = "Sarah").
4. Click Call.

• The agent initiates the call and speaks first (outbound agents always greet the callee).
• If you added dynamic variables, the agent uses those values in the greeting (e.g. “Hi Sarah, I’m calling about your renewal”).
• If the call goes to voicemail, the agent hangs up in Phase 1 (voicemail-drop is Phase 2).

​

Step 3 — Generate an outbound webhook key

1. Go to Phone Numbers → click on your number → Outbound Settings.
2. Click Generate Webhook Key.
3. Copy the key immediately — it is shown only once. Only a secure hash of it is stored.

​

Step 4 — Wire a GoHighLevel workflow

1. In GoHighLevel, create a Workflow with a Webhook action.
2. Set the URL to your integration gateway endpoint:
   https://hub.knotie-ai.pro/api/outbound-call
   
3. Set the method to POST and add the auth header:
   Authorization: Bearer <your-webhook-key>
   
4. Use GHL’s native customData format for the body:
   {
     "customData": {
       "from_number": "+14155551234",
       "to_number": "{{contact.phone}}",
       "dynamicdata_lead_name": "{{contact.full_name}}",
       "dynamicdata_outreach_topic": "your recent inquiry",
       "metadata_source": "ghl_workflow"
     }
   }
   
   The integration gateway auto-detects the GHL format — dynamicdata_* keys become dynamic variables passed to your agent.
5. Test the workflow on a contact. The agent calls the contact and addresses them by name.

​

Step 5 — Wire Facebook Lead Ads (via GHL or n8n)

1. Connect your Facebook page to GHL (Settings → Integrations → Facebook).
2. Create a GHL Workflow trigger: Facebook Lead Form Submitted.
3. Add a Webhook action pointing to the integration gateway (same as Step 4), mapping lead-form fields to dynamicdata_* keys.

1. Use the Facebook Lead Ads trigger node.
2. Add an HTTP Request node: POST to https://hub.knotie-ai.pro/api/outbound-call with:
   Authorization: Bearer <your-webhook-key>
   
   Body:
   {
     "from_number": "+14155551234",
     "to_number": "{{ $json.phone_number }}",
     "dynamic_variables": {
       "lead_name": "{{ $json.full_name }}",
       "form_source": "{{ $json.ad_name }}"
     }
   }
   

​

Dynamic variables

You are calling {{lead_name}} about {{outreach_topic}}.

{
  "dynamic_variables": {
    "lead_name": "Sarah",
    "outreach_topic": "Q3 renewal"
  }
}

You are calling Sarah about Q3 renewal.

​

Phase 1 limits

​

Troubleshooting

​

Next steps

• Outbound webhook API reference — full request/response spec for integrating external systems
• Knova Agents overview — set up and manage Knova agents
• Phone numbers — import and manage phone numbers