Inbox

curl "https://app.talkturo.com/api/inbox/list?accountSlug=acme-sales&status=open&page=0" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "total": 1,
  "page": 0,
  "pageSize": 50,
  "contacts": [
    {
      "id": "cnt_a1b2c3d4",
      "name": "Mara Weber",
      "email": "mara.weber@beispiel.de",
      "phone": "+49 30 55501234",
      "company": "Nordstern GmbH",
      "lastAt": "2025-02-14T09:30:00.000Z",
      "last": {
        "kind": "email",
        "channel": "email",
        "direction": "inbound",
        "ref": "msg_e5f6g7h8",
        "preview": "Vielen Dank für die Informationen.",
        "seconds": null,
        "assistant": "Sales Assistant"
      },
      "channels": ["email"],
      "assistants": [
        {
          "id": "ast_12345678",
          "name": "Sales Assistant"
        }
      ],
      "unread": 1,
      "needsYou": true,
      "done": false,
      "assignee": null
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/contacts?q=Mara&accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "contacts": [
    {
      "id": "cnt_a1b2c3d4",
      "name": "Mara Weber",
      "email": "mara.weber@beispiel.de",
      "company": "Nordstern GmbH"
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/contacts/cnt_a1b2c3d4/timeline?accountSlug=acme-sales&channel=email" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "contact": {
    "id": "cnt_a1b2c3d4",
    "name": "Mara Weber",
    "firstName": "Mara",
    "lastName": "Weber",
    "email": "mara.weber@beispiel.de",
    "phone": "+49 30 55501234",
    "phoneSecondary": null,
    "company": "Nordstern GmbH",
    "jobTitle": "Einkaufsleiterin",
    "leadStatus": "qualified",
    "source": "website",
    "createdAt": "2025-01-10T08:00:00.000Z",
    "lastAt": "2025-02-14T09:30:00.000Z",
    "lastChannel": "email",
    "lastAssistant": "Sales Assistant",
    "channelsUsed": ["email"],
    "done": false,
    "assignee": null,
    "groups": []
  },
  "items": [
    {
      "kind": "email",
      "id": "msg_e5f6g7h8",
      "at": "2025-02-14T09:30:00.000Z",
      "channel": "email",
      "direction": "inbound",
      "assistantId": "ast_12345678",
      "assistantName": "Sales Assistant",
      "threadId": "thr_i9j0k1l2",
      "threadUnread": true,
      "sentBy": null,
      "fromName": "Mara Weber",
      "fromAddress": "mara.weber@beispiel.de",
      "to": [{ "email": "sales@acme.ai", "name": "Sales Assistant" }],
      "subject": "Nächste Schritte",
      "text": "Vielen Dank für die Informationen.",
      "deliveryStatus": "delivered",
      "deliveryDetail": null,
      "attachments": []
    }
  ],
  "mailboxes": [
    {
      "assistantId": "ast_12345678",
      "assistantName": "Sales Assistant",
      "address": "sales@acme.ai"
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/contact-state?accountSlug=acme-sales" \
  -X POST \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "contactIds": ["cnt_a1b2c3d4"],
    "action": "assign",
    "assigneeId": "usr_m3n4o5p6"
  }'

{
  "updated": 1
}

curl "https://app.talkturo.com/api/inbox/access?accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "canManage": true,
  "me": "usr_m3n4o5p6",
  "assistants": [
    {
      "id": "ast_12345678",
      "name": "Sales Assistant"
    }
  ],
  "members": [
    {
      "id": "usr_m3n4o5p6",
      "name": "Lena Fischer",
      "email": "lena.fischer@acme.ai",
      "pictureUrl": null,
      "role": "member",
      "manager": false,
      "assistantIds": null
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/access?accountSlug=acme-sales" \
  -X PUT \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "usr_m3n4o5p6",
    "assistantIds": ["ast_12345678"]
  }'

{
  "ok": true,
  "assistantIds": ["ast_12345678"]
}

curl "https://app.talkturo.com/api/inbox/members?accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "me": "usr_m3n4o5p6",
  "members": [
    {
      "id": "usr_m3n4o5p6",
      "name": "Lena Fischer",
      "email": "lena.fischer@acme.ai",
      "pictureUrl": null,
      "role": "member"
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/availability?localPart=sales&accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "ok": true,
  "address": "sales@acme.ai"
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/calls?accountSlug=acme-sales&page=1&dir=inbound" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "calls": [
    {
      "id": "call_q7r8s9t0",
      "direction": "inbound",
      "isWeb": false,
      "isTest": false,
      "status": "completed",
      "startedAt": "2025-02-14T09:00:00.000Z",
      "endedAt": "2025-02-14T09:05:12.000Z",
      "createdAt": "2025-02-14T09:00:00.000Z",
      "durationSeconds": 312,
      "counterpartNumber": "+49 30 55501234",
      "ourNumber": "+49 30 55501000",
      "assistantName": "Sales Assistant",
      "contact": {
        "id": "cnt_a1b2c3d4",
        "name": "Mara Weber",
        "company": "Nordstern GmbH"
      },
      "summary": "Interesse an einer Produktdemo"
    }
  ],
  "hasMore": false
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/calls/call_q7r8s9t0?accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "call": {
    "id": "call_q7r8s9t0",
    "direction": "inbound",
    "isWeb": false,
    "isTest": false,
    "status": "completed",
    "startedAt": "2025-02-14T09:00:00.000Z",
    "endedAt": "2025-02-14T09:05:12.000Z",
    "createdAt": "2025-02-14T09:00:00.000Z",
    "durationSeconds": 312,
    "counterpartNumber": "+49 30 55501234",
    "ourNumber": "+49 30 55501000",
    "assistantName": "Sales Assistant",
    "contact": {
      "id": "cnt_a1b2c3d4",
      "name": "Mara Weber",
      "company": "Nordstern GmbH"
    },
    "summary": "Interesse an einer Produktdemo",
    "hasRecording": true,
    "messages": [
      {
        "role": "assistant",
        "message": "Wie kann ich Ihnen helfen?",
        "time": 2
      }
    ]
  }
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/calls/summary?accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "totals": {
    "calls": 42,
    "inbound": 25,
    "outbound": 17,
    "avgSeconds": 184
  },
  "numbers": [
    {
      "number": "+49 30 55501000",
      "kind": "phone",
      "calls": 42,
      "inbound": 25,
      "outbound": 17,
      "avgSeconds": 184,
      "lastCallAt": "2025-02-14T09:00:00.000Z",
      "assigned": true
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/mailbox?accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "emailEnabled": true,
  "pricing": {
    "perMailboxMonth": 15,
    "perThousandEmails": 2
  },
  "domain": "acme.ai",
  "suggestion": "sales",
  "mailbox": {
    "id": "mb_u1v2w3x4",
    "address": "sales@acme.ai",
    "senderName": "Sales Assistant",
    "createdAt": "2025-02-01T10:00:00.000Z",
    "unread": 3,
    "signaturePreview": "Viele Grüße",
    "defaultSenderName": "Talkturo",
    "defaultSignature": "Viele Grüße",
    "ownSenderName": null,
    "ownSignature": null
  }
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/mailbox?accountSlug=acme-sales" \
  -X POST \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{ "localPart": "sales" }'

{
  "mailbox": {
    "id": "mb_u1v2w3x4",
    "address": "sales@acme.ai"
  }
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/mailbox?accountSlug=acme-sales" \
  -X PATCH \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "senderName": "Lena vom Vertrieb",
    "signature": "Viele Grüße,
Lena"
  }'

{
  "ok": true
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/mailbox?accountSlug=acme-sales" \
  -X DELETE \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "ok": true
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/send?accountSlug=acme-sales" \
  -X POST \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -F 'payload={"mode":"new","to":[{"email":"mara.weber@beispiel.de","name":"Mara Weber"}],"cc":[],"bcc":[],"subject":"Ihre Produktdemo","text":"Gerne vereinbaren wir einen Termin.","locale":"de"}'

{
  "ok": true,
  "id": "msg_e5f6g7h8"
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/threads?accountSlug=acme-sales&folder=inbox" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "threads": [
    {
      "id": "thr_i9j0k1l2",
      "subject": "Nächste Schritte",
      "with": "Mara Weber",
      "withEmail": "mara.weber@beispiel.de",
      "unread": true,
      "messageCount": 2,
      "hasAttachments": false,
      "deliveryProblem": false,
      "lastMessageAt": "2025-02-14T09:30:00.000Z",
      "lastDirection": "inbound",
      "preview": "Vielen Dank für die Informationen."
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/threads/thr_i9j0k1l2/block?accountSlug=acme-sales" \
  -X POST \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{ "domain": true }'

{
  "ok": true,
  "pattern": "@beispiel.de"
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/threads/thr_i9j0k1l2/block?accountSlug=acme-sales&domain=1" \
  -X DELETE \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "ok": true
}

curl "https://app.talkturo.com/api/inbox/assistants/ast_12345678/threads/thr_i9j0k1l2/folder?accountSlug=acme-sales" \
  -X POST \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{ "folder": "inbox" }'

{
  "ok": true,
  "folder": "inbox",
  "contactId": "cnt_a1b2c3d4"
}

curl "https://app.talkturo.com/api/inbox/threads/thr_i9j0k1l2?accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "thread": {
    "id": "thr_i9j0k1l2",
    "subject": "Nächste Schritte",
    "mailboxAddress": "sales@acme.ai",
    "deliveryProblem": false
  },
  "messages": [
    {
      "id": "msg_e5f6g7h8",
      "direction": "inbound",
      "sentBy": null,
      "fromName": "Mara Weber",
      "fromAddress": "mara.weber@beispiel.de",
      "to": [{ "email": "sales@acme.ai" }],
      "cc": [],
      "replyTo": [],
      "subject": "Nächste Schritte",
      "text": "Vielen Dank für die Informationen.",
      "quotedText": "",
      "html": null,
      "inline": [],
      "deliveryStatus": "delivered",
      "deliveryDetail": null,
      "sentAt": "2025-02-14T09:30:00.000Z",
      "attachments": []
    }
  ]
}

curl "https://app.talkturo.com/api/inbox/threads/thr_i9j0k1l2?accountSlug=acme-sales" \
  -X POST \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{ "action": "read" }'

{
  "ok": true
}

curl "https://app.talkturo.com/api/inbox/attachments/att_y5z6a7b8?accountSlug=acme-sales" \
  -H "Authorization: Bearer tk_test_example_9xmk7q2r"

{
  "url": "https://storage.example.net/signed/att_y5z6a7b8?expires=60"
}

curl "https://app.talkturo.com/api/inbox/nylas/webhook?challenge=nylas_challenge_7f3a"

nylas_challenge_7f3a

curl "https://app.talkturo.com/api/inbox/nylas/webhook" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Nylas-Signature: 4d2f8a6e1c9b7a5f3e2d1c0b9a8f7e6d5c4b3a291817161514131211100f0e0d" \
  -d '{
    "object": "event",
    "id": "evt_c1d2e3f4",
    "type": "message.created"
  }'

{
  "ok": true
}