CallInfo Object

Top  Previous  Next  Contents  Index 

Use the CallInfo object from DWS scripts to access information about the current caller.  The macros supported in Easy Actions and the original script language do not work in DWS scripts.

 

 

The information about the current call is stored in an object named 'CallInfo'. It contains many members which can be referenced as follows:

 

Reference

Type

Description

CallInfo.Address

String

contact's Address

CallInfo.AreaCode

String

area code of the phone number (determined using phone number format)

CallInfo.CallBegan

DateTime

date and time when call started

CallInfo.CallBeganDateStr

String

date when call started, as string

CallInfo.CallBeganStr

String

date and time when call started, as string

CallInfo.CallBeganTimeStr

String

time when call started, as string

CallInfo.CallDone

Boolean

True if call is done, False if call is still in progress

CallInfo.CallDurationStr

String

duration of call, as string

CallInfo.CallEnded

DateTime

date and time when call ended

CallInfo.CallEndedStr

String

date and time when call ended, as string

CallInfo.CallLabel

String

label assigned to the call

CallInfo.CallNotes

String

notes for the call

CallInfo.City

String

contact's City

CallInfo.Company

String

contact's Company

CallInfo.ContactCallsMade

Integer

the number of calls made to this contact at any phone number owned by the contact (only accessible if contact exists (CallInfo.FoundCaller is True); always zero for devices that don't track outgoing calls)

CallInfo.ContactCallsReceived

Integer

the number of calls received from this contact from any phone number owned by the contact (only accessible if contact exists (CallInfo.FoundCaller is True))

CallInfo.ContactFirstCalled

DateTime

the first time the contact called from any phone number owned by the contact (only accessible if contact exists (CallInfo.FoundCaller is True))

CallInfo.ContactLastCalled

DateTime

the last time the contact called from any phone number owned by the contact (only accessible if contact exists (CallInfo.FoundCaller is True))

CallInfo.ContactLabel

String

label assigned to the contact

CallInfo.ContactNotes

String

notes assigned to the contact

CallInfo.Country

String

contact's Country

CallInfo.CountryCode

String

country code of the phone number (determined using phone number format)

CallInfo.County

String

contact's County

CallInfo.Custom1

String

"Custom 1" field from contact

CallInfo.Custom2

String

"Custom 2" field from contact

CallInfo.Custom3

String

"Custom 3" field from contact

CallInfo.Custom4

String

"Custom 4" field from contact

CallInfo.Date

DateTime

date of call

CallInfo.DateStr

String

same as Date, but as a string

CallInfo.DateTime

DateTime

date and time of call

CallInfo.DateTimeStr

String

same as DateTime, but as a string

CallInfo.Description

String

description of phone number (from Contact, Number page)

CallInfo.DeviceName

String

name of device on which call occurred ("Device" in Device Properties window); same as RawLine

CallInfo.DisplayName

String

contact's Display Name (same as CallInfo.Name)

CallInfo.Email

String

contact's email address

CallInfo.Extra

String

"Extra" field from contact

CallInfo.FirstName

String

contact's First Name

CallInfo.FoundCaller

Boolean

True if caller was found in Contact list

CallInfo.Incoming

Boolean

True if call is inbound, False if outbound

CallInfo.LastName

String

contact's Last Name

CallInfo.Line

String

line on which call occurred, as displayed in Call list ("Description" in Device Properties window)

CallInfo.More

String

any digits of the phone number beyond the suffix (determined using phone number format)

CallInfo.Name

String

contact's Display Name (same as CallInfo.DisplayName)

CallInfo.Number

String

phone number as displayed in Call list

CallInfo.PhoneCallsMade

Integer

the number of calls made to this phone number (always zero for devices that don't track outgoing calls)

CallInfo.PhoneCallsReceived

Integer

the number of calls received from this phone number

CallInfo.PhoneFirstCalled

DateTime

the first time a call was received from this phone number

CallInfo.PhoneLastCalled

DateTime

the last time a call was received from this phone number

CallInfo.PictureHeight

Integer

height of the contact's picture, in pixels (zero if contact has no picture)

CallInfo.PicturePathname

String

path to temporary copy of contact's picture stored in Temp folder

CallInfo.PictureWidth

Integer

width of the contact's picture, in pixels (zero if contact has no picture)

CallInfo.PostalCode

String

contact's Postal Code

CallInfo.Prefix

String

prefix (or "exchange") of the phone number (determined using phone number format)

CallInfo.RawLine

String

line on which call occurred ("Device" in Device Properties window)

CallInfo.RawName

String

name as received from TAPI or caller id device

CallInfo.RawNumber

String

phone number as received from TAPI or caller id device

CallInfo.Rings

Integer

usually 1, unless performing actions on each ring or when call ends

CallInfo.RingType

Char

type of ring for systems with distinctive ring and supporting hardware

CallInfo.ServerName

String

name of server that provided call

CallInfo.SpeakName

String

contact's Speak Name

CallInfo.State

String

contact's State

CallInfo.Suffix

String

suffix (or "number") of the phone number (determined using phone number format)

CallInfo.Time

DateTime

time of call

CallInfo.TimeStr

String

same as Time, but as a string

CallInfo.Title

String

contact's title

 

Examples

 

Speak('Call from ' + CallInfo.Name + ' at ' + CallInfo.Number);

 

if CallInfo.RawNumber = '8005551212' then

Log('mylog.txt', 'Fred called again')

else

Log('mylog.txt', CallInfo.Name);

 

Run('AddCustomer.exe',

'"' + CallInfo.FirstName + '" ' +

'"' + CallInfo.LastName + '" ' +

'"' + CallInfo.RawNumber + '" ' +

'"' + CallInfo.DateTimeStr + '" ');

 

For a complete script example, see the CallInfo sample script.