Content-type: text/html Manpage of NCID-PAGE

NCID-PAGE

Section: NCID (1)
Updated: 2022-11-8
Index Return to Main Contents
 

NAME

ncid-page - send a Caller ID or message to a cell phone, pager or other email address  

SYNOPSIS

ncid --no-gui --module ncid-page  

DESCRIPTION

The ncid-page output module sends the Caller ID or message to a cell phone, pager, or any other email address. It can have multiple email addresses.

The module always sends the information as soon as the Caller ID is received.

The ncid-page module can be configured in ncid.conf to wait until a specific number of rings before sending the Caller ID to a module when using a modem that indicates RING, or it can send the Caller ID if the call was unanswered or at the completion of the call when using a SIP gateway. Do this by creating an ncid_page variable in ncid.conf.

The module requires PageTo in ncid-page.conf to be set to the SMS gateway for your cell phone carrier.

List of SMS gateways:
https://en.wikipedia.org/wiki/List_of_SMS_gateways
 

CONFIGURATION

The ncid-page output module is configured in ncid-page.conf.
allowed_types
This sets the NCID call and/or message types ncid-page will send. See ncid-page.conf for a complete list.
Default: allowed_types="CID MSG"
IMPORTANT
If MSG is added to PageTypes and you are using the rn2ncid gateway, you must configure reject in the rn2ncid.conf file to avoid sending the message back to NCID.
PageTo
Required. Must be set to either the SMS gateway for your cell phone carrier or an email address.
Default: PageTo=""
PageFrom
This variable has no effect unless root runs ncid-page. If set, it allows root to run ncid-page as another user.
Default: PageFrom=""
PageMail
This variable sets the mail program to use in sending NCID messages.
Default: PageMail="mail"
PageOpt
This variable, if set provides a Subject line for sending email.
PageOpt=""
no subject line
PageOpt="NMBR"
calling number subject line
PageOpt="NAME"
calling name subject line
PageOpt="NONA"
calling number and name subject line
PageOpt="NANO"
calling name and number subject line

Default: PageOpt=""

 

REQUIREMENTS

mailx
Can be another mail program with an optional subject line
MTA See https://en.wikipedia.org/wiki/Message_transfer_agent Suggest a simple MTA like exim to send and receive mail. The sendmail MTA is very good but hard to configure. Use an SMTP program like SSMTP if you only need to send mail. You can use ssmtp or exim to handle mail on the Raspberry Pi. ssmtp: https://web.archive.org/web/20140831073557/https://rpi.tnet.com/project/faqs/smtp exim: http://www.sbprojects.com/projects/raspberrypi/exim4.php
To use google for outgoing mail, you need 2-step verification:
https://support.google.com/accounts/answer/180744
 

EXAMPLES

If you want to call a module on a certain ring count, you need to configure the module to set ring in the ncid.conf file.

ncid command line options to call ncid-page at ring number 4


    ncid --no-gui --module ncid-page --ring 4

ncid.conf line and ncid command line to call ncid-page if no answer


    uncomment the ncid_page line in ncid.conf and change 4 to -1
    set ncid_page {set Ring -1}


    ncid command to call ncid-page if no answer
    ncid --no-gui --module  ncid-page

 

FILES

/etc/ncid/conf.d/ncid-page.conf
/usr/share/ncid/modules/ncid-page
 

SEE ALSO

ncidd.8, ncid_modules.7, ncid.1, ncid.conf.5


 

Index

NAME
SYNOPSIS
DESCRIPTION
CONFIGURATION
REQUIREMENTS
EXAMPLES
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 18:17:41 GMT, November 12, 2022