WIwithallo
AI Receptionist

Get AI receptionist configuration

Changed on

Returns the whole configuration of a line's AI receptionist in one call: business details, voice and language, prompt, capabilities, business hours, transfer rules, connected calendars and knowledge sources. Call this before a write, because PATCH replaces whole collections.

get/v2/api/numbers/{number}/agent

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/numbers/{number}/agent
  • Auth
    API key in header Authorization

Path parameters

numberstring required
Example:+14155551234

Allo phone number in E.164 format

Response

The line's receptionist configuration

Example response

{
  "data": {
    "agent": {
      "id": "agt-abc123",
      "name": "Maya",
      "business_name": "Acme Plumbing",
      "business_address": "12 Main Street, Austin TX",
      "business_phone": "+14155551234",
      "business_email": "hello@acme.test",
      "business_website": "https://acme.test",
      "business_industry": "Plumbing",
      "language": "en-US",
      "voice_id": "maya",
      "greeting_message": "Thanks for calling Acme Plumbing, how can I help?",
      "closing_message": "Thanks for calling, have a good day."
    },
    "prompt": {
      "sections": [
        {
          "title": "Objective",
          "content": "Book a visit with the caller.",
          "fields": [
            {
              "label": "Email",
              "question": "What is the best email to send the quote to?",
              "complete_when": "a valid email address is given"
            }
          ]
        }
      ]
    },
    "business_hours": {
      "timezone": "America/New_York",
      "schedule": [
        {
          "schedule": [
            {
              "start_time": 32400,
              "end_time": 61200
            }
          ]
        }
      ]
    },
    "transfer_rules": [
      {
        "description": "Billing or invoice questions",
        "transfer_message": "Let me put you through to billing.",
        "target_number": "+14155551234"
      }
    ],
    "scheduling": {
      "calendars": [
        {
          "calendar_connection_id": "exc-abc123",
          "name": "Acme bookings",
          "event_types": [
            {
              "id": "42",
              "slug": "intro-call",
              "title": "Intro call",
              "length_in_minutes": 30,
              "description": "Book this one when the caller wants a quote.",
              "required_questions": [
                {
                  "id": "notes",
                  "label": "Anything we should know before the visit?"
                }
              ]
            }
          ]
        }
      ]
    },
    "knowledge": {
      "websites": [
        {
          "id": "ksrc-abc123",
          "url": "https://acme.test/pricing"
        }
      ],
      "files": [
        {
          "id": "ksrc-def456",
          "file_name": "pricing.pdf"
        }
      ]
    }
  }
}

Changes