Accept the caller's SMS reply into a live voice conversation

import requests
url = "https://example.ada.support/api/v2/conversations/conversation_id/sms/"
payload = {
    "author": {
        "role": "end_user",
        "id": "5df263b7db5a7e6ea03fae9b"
    },
    "content": {
        "type": "text",
        "body": "ABC123"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "5df263b7db5a7e6ea03fae9b",
  "conversation_id": "5df263b7db5a7e6ea03fae9b",
  "author": {
    "role": "end_user",
    "id": "5df263b7db5a7e6ea03fae9b",
    "avatar": "https://www.gravatar.com",
    "display_name": "Ada Lovelace"
  },
  "content": {
    "type": "text",
    "body": "Hello, how can I help you?"
  },
  "created_at": "2020-09-20T00:00:00+00:00",
  "updated_at": "2020-09-20T00:00:00+00:00"
}

Accept a text the caller sent during a live voice call over the AI Agent’s own SMS channel. Send author.role as end_user with the caller’s author.id from the webhook’s data.end_user_id, and content.type as text. The reply becomes the caller’s next turn and the AI Agent answers by voice on the call. Ada accepts a reply only on a live voice call it has already texted over your SMS channel, with Use your own SMS channel turned on.

Accept a text the caller sent during a live voice call over the AI Agent's own SMS channel. Send `author.role` as `end_user` with the caller's `author.id` from the webhook's `data.end_user_id`, and `content.type` as `text`. The reply becomes the caller's next turn and the AI Agent answers by voice on the call. Ada accepts a reply only on a live voice call it has already texted over your SMS channel, with **Use your own SMS channel** turned on.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

conversation_idstringRequiredformat: "id"

The ID of the conversation

Request

This endpoint expects an object.

authorobjectRequired

Information about the message author

contentobjectRequired

The message content

Response

Reply accepted into the live call. The response returns content.body as sent.

idstringOptionalRead-onlyformat: "id"

The ID of the message

conversation_idstringOptionalRead-onlyformat: "id"

The ID of the conversation

authorobjectOptional

Information about the message author

contentobjectOptional

The message content

created_atstringOptionalRead-onlyformat: "date-time"

The date and time the message was created

updated_atstringOptionalRead-onlyformat: "date-time"

The date and time the message was updated

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error