messageservice.sender.add

Scope: messageservice Права на выполнение: для всех

messageservice.sender.add - регистрирует новый SMS-провайдер. Успешное выполнение метода возможно только в рамках созданного приложения.

Параметры

На HANDLER приходят данные:

• module_id - модуль-инициатор. crm - значит сообщение отправлено из карточки (в будущем могут быть и другие варианты), bizproc - отправлено из Бизнес Процессов или робота.
• bindings - параметр, актуальный только для module_id = crm. В нем содержится массив привязок сообщения к сущностям CRM (к чему привяжется дело).
• workflow_id, document_id, document_type - параметры, актуальные только для module_id = bizproc. Параметры приходят не всегда: если отправляем из карточки, то их не будет)
• message_id - уникальный идентификатор сообщения. По нему можно обращаться к messageservice.message.status.update.
• message_to - номер получателя сообщения
• message_body - текст сообщения

Пример

var params = {
	CODE: 'provider1',
	TYPE: 'SMS',
	HANDLER: 'http:///',
	NAME: 'Провайдер ***.ru',
	DESCRIPTION: 'Провайдер ***.ru'
};
BX24.callMethod(
	'messageservice.sender.add',
	params,
	function(result)
	{
		if(result.error())
			alert("Error: " + result.error());
		else
			alert("Успешно: " + result.data());
	}
);

Отправление из карточки CRM

Array
(
	[module_id] => crm
	[bindings] => Array
		(
			[0] => Array
				(
					[OWNER_TYPE_ID] => 1
					[OWNER_ID] => 98
				)

		)

	[properties] => Array
		(
			[phone_number] => +7*********
			[message_text] => test message
		)

	[type] => SMS
	[code] => example
	[message_id] => 72dd742c8270db0ddbbab92f98877537
	[message_to] => +7**********
	[message_body] => test message
	[ts] => 1506687055
	[auth] => /*auth*/

)

Отправление из Бизнес-процесса или робота.

Array
(
	[module_id] => bizproc
	[workflow_id] => 59ce38567ff2a5.26351167
	[document_id] => Array
		(
			[0] => crm
			[1] => CCrmDocumentLead
			[2] => LEAD_98
		)

	[document_type] => Array
		(
			[0] => crm
			[1] => CCrmDocumentLead
			[2] => LEAD
		)

	[properties] => Array
		(
			[phone_number] => +7*********
			[message_text] => test message
		)

	[type] => SMS
	[code] => example
	[message_id] => 8b3fc6cd0cb4a7b91f6632889cdf46e0
	[message_to] => +7*********
	[message_body] => test message
	[ts] => 1506687103
	[auth] => /*auth*/

)