7.3 API - Zenvia: Envio de SMS via Zenvia no CRM One

O CRM One permite o envio de SMS através da integração com a Zenvia, disponível mediante contratação adicional.

Pré-requisitos

• Ter uma conta ativa na Zenvia com plano contratado
• CRM One Add-on versão 2021.09.6.001 ou superior

Como contratar Zenvia

Você pode contratar o serviço de SMS diretamente no site oficial da Zenvia:

➡️ Acessar Zenvia

Integração com a API Zenvia

A integração utiliza o endpoint REST:

https://api-rest.zenvia.com/services/send-sms

Consulte a 📘 documentação oficial para verificar portas, permissões e retornos da API.

Arquitetura de Funcionamento

O CRM One utiliza a tabela @DWU_MSG_SMS no banco do SAP B1. Ela pode ser alimentada manualmente por formulário ou por comandos SQL automáticos.

Tabela @DWU_MSG_SMS - Campos Padrão

Consulte a tabela completa no manual acima. Alguns campos importantes:

• U_Destinatario: número no formato internacional (ex: 5511987654321)
• U_TextoSMS: mensagem com até 160 caracteres (sem acento) ou 70 (com acento)
• U_Status: 'N' (não enviado) ou 'Y' (enviado)
• U_StatusCode, U_DetailCode: retorno da Zenvia

Exemplo de função SQL para SAP HANA

CREATE PROCEDURE CRMONE_ENVIOSMS
(
  Filtro INT
)
LANGUAGE SQLSCRIPT
AS
BEGIN
  DECLARE CONTADOR INTEGER = :Filtro;

  DECLARE CURSOR _cursor FOR
    SELECT ... FROM "DUMMY";

  FOR _cursorRow AS _cursor
  DO
    CONTADOR = CONTADOR + 1;
    INSERT INTO "@DWU_MSG_SMS" (...) VALUES (...);
  END FOR;

  CLOSE _cursor;
END

Configuração no SAP

No SAP, vá até:

Módulos > CRM One > Configurações > Serviços > Configuração de envio de SMS

Campos principais:

• Usuário / Senha: fornecidos pela Zenvia
• Endereço: https://api-rest.zenvia.com/services/send-sms
• Tempo Sinc: intervalo de verificação (ex: 5 min)
• Limite diário: total máximo de mensagens
• Envio: JSON a ser enviado
• Retorno: JSON de retorno da Zenvia

Tabelas de retorno da API Zenvia

🔸 statusCode

• 00: Ok
• 02: Sent
• 03: Delivered
• 06: Blocked – Black listed
• 10: Error
• 11: Verified

🔸 detailCode

• 000: Message Sent
• 012: Message content overflow
• 013: Número incompleto
• 130: Message blocked
• 900: Authentication error