Placetel MCP by usefulapi
Read Placetel calls, recordings, numbers and routing; edit contacts, start calls, send SMS.
사용해야 할까요
품질 및 안전성
A
발견 사항 (5)
- LOWTool 'placetel_list_call_detail_records' name length outside 3-30 rangeplacetel_list_call_detail_records에서
- LOWTool 'placetel_list_call_center_queues' name length outside 3-30 rangeplacetel_list_call_center_queues에서
- LOWTool 'placetel_list_call_center_agents' name length outside 3-30 rangeplacetel_list_call_center_agents에서
- LOWTool 'placetel_list_call_center_calls' name length outside 3-30 rangeplacetel_list_call_center_calls에서
- LOWTool 'placetel_activate_number_profile' name length outside 3-30 rangeplacetel_activate_number_profile에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~6,762토큰 (도구 정의)
~1.9 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 5.28%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"placetel": {
"url": "https://placetel.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://placetel.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (28)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢placetel_get_account
The Placetel account this API key belongs to: user id, name, email, company, platform (e.g. PROFI), primary SIP user id and the numbers the key may use. GET /me.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_users(first_name, last_name, email, login, type, ...)
List the web users of the account (main account and sub-users) with name, email, login, type, permissions and numbers. Filter by name, email, login or type. GET /users.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"description": "Filter by first name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"last_name": {
"description": "Filter by last name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Filter by email.",
"type": "string",
"minLength": 1,
"maxLength": 254
},
"login": {
"description": "Filter by login.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"type": {
"description": "Only the main account or only sub-users.",
"type": "string",
"enum": [
"main_account",
"subuser"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_sip_users(did, username, name, description, page, ...)
List SIP users (phone extensions, softphones, fax and trunk lines) with extension number (did), caller id, type, online state and registrations. SIP passwords and PINs are never returned. GET /sip_users.
입력 스키마
{
"type": "object",
"properties": {
"did": {
"description": "Filter by internal extension number.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"username": {
"description": "Filter by SIP username.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"name": {
"description": "Filter by name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"description": "Filter by description.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_get_sip_user(sip_user_id)
One SIP user (extension) by id: sipuid, extension, caller id, type, linked web user, online state and call settings. The SIP password and PINs are never returned. GET /sip_users/{id}.
입력 스키마
{
"type": "object",
"properties": {
"sip_user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel SIP user id (from placetel_list_sip_users)."
}
},
"required": [
"sip_user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_calls(date, from_number, to_number, type, order, ...)
Incoming calls (accepted, missed, blocked, voicemail) on one day, today by default: caller number, called number, duration, matching contact, voicemail file URL and unread flag. For a different day pass date. GET /calls.
입력 스키마
{
"type": "object",
"properties": {
"date": {
"description": "Day to list, yyyy-mm-dd (default: today).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"from_number": {
"description": "Only calls from this caller number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"to_number": {
"description": "Only calls to this of your numbers.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"type": {
"description": "Call outcome filter.",
"type": "string",
"enum": [
"voicemail",
"missed",
"blocked",
"accepted",
"voicemail,missed",
"missed,blocked,accepted"
]
},
"order": {
"description": "Sort order by time.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_get_call(call_id)
One incoming call by id: caller, called number, type, duration, contact, voicemail file URL. GET /calls/{id}.
입력 스키마
{
"type": "object",
"properties": {
"call_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel call id (from placetel_list_calls)."
}
},
"required": [
"call_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_call_detail_records(date, page, per_page)
Call detail records (billing view) for one day: from, to, answering SIP user, length in seconds, cost amount and description. date is required. GET /call_detail_records.
입력 스키마
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Day to list, yyyy-mm-dd."
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"required": [
"date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_recordings(direction, from, to, date, order, ...)
Call recordings with direction, from, to, duration, time and the file URL. Filter by direction, number or day. GET /recordings.
입력 스키마
{
"type": "object",
"properties": {
"direction": {
"description": "Directions to include, e.g. [\"in\",\"out\"].",
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 20
}
},
"from": {
"description": "Only recordings from this number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"to": {
"description": "Only recordings to this number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"date": {
"description": "Only recordings of this day, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"order": {
"description": "Sort order by time.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_contacts(first_name, last_name, company, email, email_work, ...)
List the shared phone-book contacts with names, company, phone/mobile/fax numbers, emails, tags and blocked flag. Filter by name, company, email, number or update time. search_number finds a contact by any of its numbers. GET /contacts.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"description": "Filter by first name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"last_name": {
"description": "Filter by last name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"company": {
"description": "Filter by company.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Filter by private email.",
"type": "string",
"minLength": 1,
"maxLength": 254
},
"email_work": {
"description": "Filter by work email.",
"type": "string",
"minLength": 1,
"maxLength": 254
},
"phone": {
"description": "Filter by private phone.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"phone_work": {
"description": "Filter by work phone.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"mobile": {
"description": "Filter by private mobile.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"mobile_work": {
"description": "Filter by work mobile.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"speeddial": {
"description": "Filter by speed-dial code.",
"type": "integer",
"minimum": 0,
"maximum": 9999999
},
"blocked": {
"description": "Only blocked (true) or only non-blocked (false) contacts.",
"type": "boolean"
},
"updated_since": {
"description": "Only contacts updated at or after this date/time.",
"type": "string"
},
"updated_until": {
"description": "Only contacts updated at or before this date/time.",
"type": "string"
},
"search_number": {
"description": "Find the contact that owns this phone number (any of its number fields).",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_get_contact(contact_id)
One contact by id with all its fields. GET /contacts/{id}.
입력 스키마
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel contact id (from placetel_list_contacts)."
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_numbers(prefix, number, name, description, activated, ...)
List the phone numbers of the account with number, E.164 form, name, description, site, activation state and the routing object id that answers them. GET /numbers.
입력 스키마
{
"type": "object",
"properties": {
"prefix": {
"description": "Filter by area-code prefix.",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"number": {
"description": "Filter by number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"name": {
"description": "Filter by name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"description": "Filter by description.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"activated": {
"description": "Only activated (true) or deactivated (false) numbers (Profi plans).",
"type": "boolean"
},
"site_id": {
"description": "Only numbers of this site (see placetel_list_sites).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_get_number(number_id)
One phone number by id: number, E.164, name, site, carrier, activation state and routing id. GET /numbers/{id}.
입력 스키마
{
"type": "object",
"properties": {
"number_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel number id (from placetel_list_numbers)."
}
},
"required": [
"number_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_number_profiles(number_id)
The routing profiles of a phone number (for example Standard, Holiday, Night) and which one is active. Needs a Placetel plan with number profiles. GET /numbers/{number_id}/profiles.
입력 스키마
{
"type": "object",
"properties": {
"number_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel number id."
}
},
"required": [
"number_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_routings(updated_since, updated_until, page, per_page)
List routing objects (what happens to an incoming call: forward, group, routing plan, IVR, queue, voicemail, API) with their settings and time settings. Filter by update time. GET /routings.
입력 스키마
{
"type": "object",
"properties": {
"updated_since": {
"description": "Only routings updated at or after this date/time.",
"type": "string"
},
"updated_until": {
"description": "Only routings updated at or before this date/time.",
"type": "string"
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_get_routing(number_or_id)
One routing object by its id or by the phone number it answers. GET /routings/{number_or_id}.
입력 스키마
{
"type": "object",
"properties": {
"number_or_id": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "A routing id (e.g. 4711) or a phone number (e.g. 022112345678)."
}
},
"required": [
"number_or_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_routing_plans(page, per_page)
List routing plans (time-based call distribution plans) with name, description, ring duration and object counts. GET /routing_plans.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_groups(name, description, type, page, per_page)
List ring groups (ring_all, hunt, monitoring) with members. Filter by name, description or type. GET /groups.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"description": "Filter by name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"description": "Filter by description.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"type": {
"description": "Group type.",
"type": "string",
"enum": [
"ring_all",
"monitoring",
"hunt"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_sites(page, per_page)
List company sites (locations) with address and prefix. GET /sites.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_faxes(type, from_number, to_number, order, page, ...)
In- and outbound faxes with from/to number, status, pages, duration, type and the file URL. Filter by direction or number. GET /faxes.
입력 스키마
{
"type": "object",
"properties": {
"type": {
"description": "Direction filter.",
"type": "string",
"enum": [
"inbound,outbound",
"inbound",
"outbound"
]
},
"from_number": {
"description": "Only faxes from this number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"to_number": {
"description": "Only faxes to this number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"order": {
"description": "Sort order.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_get_fax(fax_id)
One fax by id: numbers, status, status info, pages, retries, report and file URL. GET /faxes/{id}.
입력 스키마
{
"type": "object",
"properties": {
"fax_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel fax id (from placetel_list_faxes)."
}
},
"required": [
"fax_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_call_center_queues(page, per_page)
List call-center queues with name, ring time, loops and prompts. Use the ids to filter call-center calls. GET /call_center_queues.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_call_center_agents(page, per_page)
List call-center agents with name, status, extension, priority and last call time. GET /call_center_agents.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢placetel_list_call_center_calls(date, queue_ids, page, per_page)
Call-center calls of one day with queue, agent, from/to, answer status, start/end time and time spent in queue. date is required; narrow to queues with queue_ids. GET /call_center_calls.
입력 스키마
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Day to list, yyyy-mm-dd."
},
"queue_ids": {
"description": "Only these queue ids (see placetel_list_call_center_queues).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-100 (default 25). Not every endpoint honours it; keep paging until a page is empty.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"required": [
"date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡placetel_create_contact(first_name, last_name, company, email, email_work, ...)
WRITE: create a contact in the shared Placetel phone book. Give at least a name, company or number. Nothing is sent to the contact. POST /contacts.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"description": "First name.",
"type": "string",
"maxLength": 200
},
"last_name": {
"description": "Last name.",
"type": "string",
"maxLength": 200
},
"company": {
"description": "Company.",
"type": "string",
"maxLength": 200
},
"email": {
"description": "Private email address.",
"type": "string",
"maxLength": 254
},
"email_work": {
"description": "Work email address.",
"type": "string",
"maxLength": 254
},
"phone": {
"description": "Private phone number.",
"type": "string",
"maxLength": 40
},
"phone_work": {
"description": "Work phone number.",
"type": "string",
"maxLength": 40
},
"mobile": {
"description": "Private mobile number.",
"type": "string",
"maxLength": 40
},
"mobile_work": {
"description": "Work mobile number.",
"type": "string",
"maxLength": 40
},
"fax": {
"description": "Private fax number.",
"type": "string",
"maxLength": 40
},
"fax_work": {
"description": "Work fax number.",
"type": "string",
"maxLength": 40
},
"address": {
"description": "Private address.",
"type": "string",
"maxLength": 300
},
"address_work": {
"description": "Work address.",
"type": "string",
"maxLength": 300
},
"speeddial": {
"description": "Speed-dial code.",
"type": "string",
"maxLength": 20
},
"tags": {
"description": "Tags (replaces the existing tags on update; [] clears them).",
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
}
},
"blocked": {
"description": "true = calls from this contact are blocked.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴placetel_update_contact(contact_id, first_name, last_name, company, email, ...)
WRITE: update the given fields of a contact (omitted fields stay; an empty string clears a text field). tags replaces the whole tag list; blocked=true blocks the caller. PUT /contacts/{id}.
입력 스키마
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel contact id."
},
"first_name": {
"description": "First name.",
"type": "string",
"maxLength": 200
},
"last_name": {
"description": "Last name.",
"type": "string",
"maxLength": 200
},
"company": {
"description": "Company.",
"type": "string",
"maxLength": 200
},
"email": {
"description": "Private email address.",
"type": "string",
"maxLength": 254
},
"email_work": {
"description": "Work email address.",
"type": "string",
"maxLength": 254
},
"phone": {
"description": "Private phone number.",
"type": "string",
"maxLength": 40
},
"phone_work": {
"description": "Work phone number.",
"type": "string",
"maxLength": 40
},
"mobile": {
"description": "Private mobile number.",
"type": "string",
"maxLength": 40
},
"mobile_work": {
"description": "Work mobile number.",
"type": "string",
"maxLength": 40
},
"fax": {
"description": "Private fax number.",
"type": "string",
"maxLength": 40
},
"fax_work": {
"description": "Work fax number.",
"type": "string",
"maxLength": 40
},
"address": {
"description": "Private address.",
"type": "string",
"maxLength": 300
},
"address_work": {
"description": "Work address.",
"type": "string",
"maxLength": 300
},
"speeddial": {
"description": "Speed-dial code.",
"type": "string",
"maxLength": 20
},
"tags": {
"description": "Tags (replaces the existing tags on update; [] clears them).",
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
}
},
"blocked": {
"description": "true = calls from this contact are blocked.",
"type": "boolean"
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴placetel_activate_number_profile(number_id, profile_id)
WRITE: switch the active routing profile of a phone number (for example to Holiday or Night). This changes LIVE call handling for that number immediately: callers are routed differently. Find ids with placetel_list_number_profiles. PUT /numbers/{number_id}/profiles.
입력 스키마
{
"type": "object",
"properties": {
"number_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Placetel number id."
},
"profile_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Id of the profile to activate."
}
},
"required": [
"number_id",
"profile_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡placetel_initiate_call(sipuid, target, from_name)
WRITE: start a real phone call. Placetel rings the given SIP user's phone first and, once answered, dials the target number. This places an actual call and call charges apply. Do not use without the user's explicit request. POST /calls.
입력 스키마
{
"type": "object",
"properties": {
"sipuid": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,64}@[A-Za-z0-9.-]{1,100}$",
"description": "SIP user that is rung first, e.g. [email protected] (the sipuid from placetel_list_sip_users)."
},
"target": {
"type": "string",
"pattern": "^\\+?[0-9][0-9 ()\\/-]{2,39}$",
"description": "Number to call, e.g. +4922112345678."
},
"from_name": {
"description": "Name shown for the call.",
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"sipuid",
"target"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡placetel_send_sms(recipient, message)
WRITE: send a real SMS to a phone number from the Placetel account. The recipient receives it immediately and SMS charges apply; it cannot be recalled. Do not use without the user's explicit request and exact text. POST /sms.
입력 스키마
{
"type": "object",
"properties": {
"recipient": {
"type": "string",
"pattern": "^\\+?[0-9][0-9 ()\\/-]{2,39}$",
"description": "Recipient number, e.g. +4915112345678."
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 1600,
"description": "The exact message text (sent unchanged)."
}
},
"required": [
"recipient",
"message"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 28개