CVcvcrm
Envio de Mensagens

Envio de mensagens/criação de conversas por serviços externos

🔒 Autenticação necessária

Esta API utiliza Bearer Token no header Authorization. Consulte o tutorial completo antes de fazer sua primeira chamada: Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)

Envio de mensagens por serviços externos

Chat aguardando pesquisa de satisfação: quando o contato tem, no canal, um chat encerrado que ficou aguardando a resposta da pesquisa, a mensagem é entregue à pesquisa antes de qualquer identificação do cliente. Se for resposta, é gravada na pesquisa e não entra em nenhum chat ativo (o retorno vem com sucesso: true e identificador vazio). Se não for, a pesquisa é abandonada, o chat encerrado não é reaberto e a mensagem segue o fluxo normal, que cria um chat novo. O contrato da requisição e da resposta não muda.

Eco do app WhatsApp Business (API oficial em Coexistence): o webhook da Meta com field: smb_message_echoes (mensagens que a empresa enviou, editou ou apagou pelo app do celular) também chega nesta rota. A mensagem é gravada no chat do destinatário (to) como enviada pela empresa, sem reabrir a janela de 24h nem notificar o atendente; contato sem chat no canal ganha chat, como numa conversa nova. Edição (edit) troca o texto e marca a mensagem como editada; revogação (revoke) marca como apagada. Eco já gravado (mesmo id) é ignorado. A resposta segue o mesmo contrato.

post/mensagem/{origem}/{servico}

Request

  • Base URL
    https://integracao.cvcrm.com.br/api/v1/comunicador
  • URL
    https://integracao.cvcrm.com.br/api/v1/comunicador/mensagem/{origem}/{servico}
  • Auth
    HTTP bearer

Path parameters

origemstring required
Example:wpp

origem da conversa (WPP/SITE)

servicostring required
Example:BTM

Serviço de envio de mensagens (BTM = Botmaker)

Request body

OR

Example request

{
  "identificador_chat": "f711822ff5daf4c77d2c46ba59ca78a02474d8c551f23014b38f7a8cb78e9ae3",
  "mensagem": {
    "idmensagem": "PrA1FxHNUtO8keI-gB.B61QFyQ",
    "texto": "Bom dia, preciso de ajuda com o IPTU.",
    "data": "2026-08-31 10:15:42",
    "emissor": "C",
    "reply": "PrA1FxHNUtO8keI-gB.B61QFyQ",
    "cliente": {
      "nome": "Maria Souza",
      "telefone": "+557988888888",
      "link_id": "182736451234567"
    },
    "midia": {
      "url": "https://storage.cliente.com.br/audios/273287e1926a267.ogg",
      "tipo": "audio",
      "nome": "comprovante.pdf",
      "duracao": 12
    }
  },
  "mensagens": [
    {
      "idmensagem": "PrA1FxHNUtO8keI-gB.B61QFyQ",
      "texto": "Bom dia, preciso de ajuda com o IPTU.",
      "data": "2026-08-31 10:15:42",
      "emissor": "C",
      "reply": "PrA1FxHNUtO8keI-gB.B61QFyQ",
      "cliente": {
        "nome": "Maria Souza",
        "telefone": "+557988888888",
        "link_id": "182736451234567"
      },
      "midia": {
        "url": "https://storage.cliente.com.br/audios/273287e1926a267.ogg",
        "tipo": "audio",
        "nome": "comprovante.pdf",
        "duracao": 12
      }
    }
  ],
  "informacoes": {
    "idpessoa": 4321,
    "idatendimento": 520,
    "atendimento": {
      "idpessoa": 4321,
      "documento": "23375876068",
      "nome_cliente": "Maria João",
      "email_cliente": "maria@exemplo.com.br",
      "idassunto": 2,
      "idsubassunto": 14,
      "titulo": "IPTU",
      "descricao": "Anos 2024 e 2025"
    },
    "idlead": 812,
    "idempreendimento": 37
  }
}

Response

Sucesso

object required

Example response

{
  "sucesso": true,
  "identificador": "115a4798a005947fe2ea0e9e0b7017b38444514d0bd05e0e8cd555077",
  "idMensagem": "-NrBlTwjaI6Mv6WrV"
}

Changes

No recorded changes to this operation across all 1 revision of this API.