Riferimento API

Chiamate

Verificare app.capabilities per il supporto delle funzionalità e app.access insieme alle autorizzazioni host per l’autorizzazione. Gli esempi usano valori sintetici; sostituire percorsi, ID, input e filtri prima della chiamata.

Definizioni di tipo

graphql
type Mutation {
  call(number: String!, showDialer: Boolean!): Boolean!
  deleteCalls(query: String!): ActionResult!
}

type Query {
  callCount(query: String!): Int!
  calls(query: String!, offset: Int!, limit: Int!): [Call!]!
}

type ActionResult {
	affectedCount: Int!
}

type Call {
	typeCode: Int!
	id: ID!
	number: String!
	name: String!
	photo: String!
	startedAt: Instant!
	durationSec: Int!
	type: CallType!
	accountId: ID!
	geo: PhoneGeo
	tags: [Tag!]!
}

enum CallType {
	INCOMING
	OUTGOING
	MISSED
	VOICEMAIL
	REJECTED
	BLOCKED
	ANSWERED_EXTERNALLY
	UNKNOWN
}

enum DataType {
	DEFAULT
	AUDIO
	VIDEO
	IMAGE
	SMS
	CONTACT
	NOTE
	FEED_ENTRY
	CALL
	PACKAGE
	FILE
	APP_FILE
	DOC
}

scalar Instant

type PhoneGeo {
	country: String!
	numberType: PhoneNumberType!
	carrier: String!
	description: String!
}

enum PhoneNumberType {
	FIXED_LINE
	MOBILE
	FIXED_LINE_OR_MOBILE
	TOLL_FREE
	PREMIUM_RATE
	SHARED_COST
	PERSONAL_NUMBER
	VOIP
	PAGER
	UAN
	VOICEMAIL
}

type Tag {
	id: ID!
	name: String!
	type: DataType!
	count: Int!
}

Operazioni

mutation

call

Avviare una chiamata al numero indicato. Impostare showDialer su true per aprire il tastierino dell’app Telefono invece di chiamare subito. Richiede l’autorizzazione CALL_PHONE.

graphql
# `showDialer` hands the number to the dialer instead of placing the
# call outright.
mutation call($number: String!, $showDialer: Boolean!) {
  call(number: $number, showDialer: $showDialer)
}
mutation

deleteCalls

Eliminare le voci del registro chiamate corrispondenti a una query.

graphql
mutation deleteCalls($query: String!) {
  deleteCalls(query: $query) { affectedCount }
}
query

callCount

Contare le chiamate corrispondenti a una query.

graphql
query callCount($query: String!) {
  callCount(query: $query)
}
query

calls

Cercare voci del registro chiamate. Lasciare query vuoto per elencarle tutte.

graphql
query calls($query: String!, $offset: Int!, $limit: Int!) {
  calls(query: $query, offset: $offset, limit: $limit) { typeCode id number name photo startedAt durationSec type }
}