Famulor icon

Famulor

Make phone calls using AI assistants from Famulor platform

Overview

This node enables making phone calls using AI assistants from the Famulor platform. It is designed to automate outbound calls by leveraging customizable AI assistants that can interact with customers over the phone. Typical use cases include customer support callbacks, appointment reminders, surveys, or any scenario where automated voice interaction is beneficial.

For example, a business could use this node to automatically call customers and provide personalized messages or gather information by passing variables such as the customer's name to the assistant.

Properties

Name Meaning
Assistant Name or ID Select an AI assistant from your Famulor account or specify its ID via expression.
Customer Phone Number The phone number of the customer to call.
Variables Key-value pairs of variables to pass to the assistant for personalization (e.g., customer name).
  • Assistant Name or ID: Loaded dynamically from your Famulor account's outbound assistants.
  • Variables: Allows multiple variables; each variable has a "Name" and a "Value" string field.

Output

The node outputs JSON data representing the response from the Famulor API after attempting to make the call. The structure typically includes details about the call request status and any relevant metadata returned by the API.

Example output JSON might look like:

{
  "callId": "123456",
  "status": "queued",
  "assistant_id": "abcde",
  "phone_number": "+491234567890",
  "variables": {
    "Customer Name": "John"
  }
}

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for the Famulor platform to authenticate requests.
  • The node makes HTTP requests to the Famulor API endpoints:
    • https://app.famulor.de/api/user/make_call for making calls.
    • https://app.famulor.de/api/user/assistants/outbound to load available outbound assistants.
  • Proper network connectivity to the Famulor API is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Providing an invalid phone number format may result in API errors.
    • If no outbound assistants are configured in the Famulor account, the assistant selection list will be empty.
    • Rate limiting errors (HTTP 429) are handled with retries, but excessive calls may still fail.

  • Error messages:

    • "Failed to load assistants: ..." indicates problems fetching assistants, often due to credential or network issues.
    • "The operation \"make\" is not known!" means an unsupported operation was requested.
    • "The resource \"call\" is not known!" means an unsupported resource was specified.
    • "Invalid response format" suggests unexpected API responses, possibly due to API changes or connectivity problems.

  • Resolutions:

    • Verify the API key is correct and has required permissions.
    • Ensure phone numbers are in the expected international format.
    • Create at least one outbound assistant in the Famulor platform before using the node.
    • Check network access and retry later if rate limits are hit.

Links and References

Discussion