Phone calls

• Nur dials a number and has the conversation your instructions describe, in the person’s language. They can talk over it and ask it anything.
• An exact first sentence when it matters, such as one that names the person.
• Nur hangs up by itself when the conversation is over or the person asks.
• The call’s status, length and transcript once it ends.

​

Run it

pip install "eesi-sdk @ git+https://github.com/eesi-ai/eesi-sdk-python"
export EESI_API_KEY=sk-eesi-...
python call.py

import asyncio

from eesi import NurClient

NUMBER = "+14155550123"  # yours, in E.164


async def main():
    nur = NurClient()
    await nur.verify_phone_number(NUMBER)  # Nur texts it a six-digit code
    await nur.confirm_phone_number(NUMBER, input("Code: "))
    call = await nur.call(
        NUMBER,
        instructions="You are Nur, calling Sam for Example Deliveries to confirm tomorrow's delivery between 10 and 12. If that doesn't suit, offer 2 to 4 or 4 to 6.",
        greeting="Hi Sam, it's Nur from Example Deliveries.",
    )
    ended = await nur.wait_for_call(call.id)
    print(ended.status)
    for role, text in ended.transcript:
        print(f"{role}: {text}")


asyncio.run(main())

​

Over HTTP

curl https://api.eesi.ai/v1/phone/calls \
  -H "Authorization: Bearer $EESI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550123",
    "instructions": "You are Nur, calling Sam for Example Deliveries to confirm tomorrow'\''s delivery between 10 and 12.",
    "greeting": "Hi Sam, it'\''s Nur from Example Deliveries.",
    "metadata": {"order": "A-1042"}
  }'

​

Good to know

• Keys the person presses on their phone reach Nur as a message from them.
• When your organization records calls, each call opens with “This call is being recorded.”, which nobody can talk over.
• On the shared line, an organization places up to 30 calls an hour and sends up to five codes a day. To call your customers from your own number, write to founders@eesi.ai.

​

Next