Agent Integration Responsibilities
| Layer | Responsibility |
|---|---|
| Integration connection | Stores and validates credentials at the organization level. |
| Action catalog | Defines the provider action, inputs, and label. |
| Agent function | Exposes a selected action to the model with a clear description. |
| Prompt | Explains when the agent should use the action and what consent or information is required. |
| Call History | Shows conversation evidence around whether the action should have run. |
| Invocation evidence | Shows whether the provider accepted the action and which fields were missing or failed. |
When To Use An Integration During A Call
| Scenario | Good agent action? | Reason |
|---|---|---|
| Caller asks for a WhatsApp confirmation and the number is known | Yes, Wati can send a message if the function is configured. | The caller intent is clear and the required field exists. |
| Caller asks for an email summary and the email is confirmed | Yes, Resend can send a follow-up email. | The action matches the live request. |
| Workflow should follow up after every completed call | Usually no, use a workflow instead. | Post-call automation is more reliable outside live conversation. |
| Action depends on slow external data | Be careful. | Slow actions create silence during the call unless the prompt handles waiting. |
Add An Integration Action To An Agent
Choose the action
Pick the action that matches the caller-facing outcome, such as a Wati message or Resend email.
Write a strict function description
Tell the model when to use the action, what values it needs, and when not to call it.
Collect required values
Use dynamic variables if the data is known before the call, or prompt the agent to ask the caller when the data is missing.
Test with caller phrases
Test direct requests, vague requests, no-consent cases, and missing-field cases.
Agent Integration Risks
Action runs too early
Action runs too early
Tighten the function description and prompt. Require explicit caller intent or required data before the model can call the action.
Action never runs
Action never runs
Make the trigger condition clearer and test with direct caller language that should call the action.
Missing field error
Missing field error
Add dynamic variables, collect the value during the call, or move the action into a workflow after post-call extraction.
Credential expired
Credential expired
Validate the integration connection again before editing the agent prompt.
Live call goes silent
Live call goes silent
Check integration latency. If the action does not need to happen before the agent replies, move it to a workflow.
Related Reading
Agent Functions
Expose actions to agents.
Connecting Integrations
Set up credentials.
Integration Functions
Review invocation evidence.
Call Detail Page
Review action context.