> For the complete documentation index, see [llms.txt](https://ajuda.ccmpedidoonline.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.ccmpedidoonline.com.br/documentacao-e-integracoes/nossas-integracoes/integracao-ccm-mensageiro.md).

# Integração CCM Mensageiro

Use a integração com o CCM Mensageiro para notificar seus clientes via Whatsapp.

## Sobre a integração

A API do CCM Mensageiro pode ser utilizada nos seguintes cenários:

* Envio de notificações transacionais sobre o status do pedido
* Envio de mensagens promocionais

{% hint style="warning" %}
**Cuidado**! Mensagens promocionais devem ser utilizadas com moderação, a CCM Pedido Online não se responsabiliza pelo mau uso desta funcionalidade.
{% endhint %}

## Acesso a API wsMensageiro V1

**api.ccmpedidoonline.com.br/wsMensageiro.php**

### Parâmetros de entrada 

{% hint style="warning" %}
**Atenção!** Todos os parâmetros de entrada são obrigatórios.
{% endhint %}

Enviar os parâmetros via HTTP GET.

| Parâmetro             | Descrição                                                                                                    | Exemplo                          |
| --------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------- |
| token                 | Token do estabelecimento. Disponível em CCM Retaguarda -> Configurações -> Integrações                       | 5ea2a34dd6dd9c5493e6655e783aa8ce |
| codFilial             | Código da Filial. Disponível em CCM Retaguarda -> Configurações -> Integrações                               | 1                                |
| telefone              | Número do telefone com DDD                                                                                   | 11981828384                      |
| codCliente (opcional) | Código do cliente no CCM. Este valor está no cabeçalho dos pedidos, e também nos relatórios do CCM Extranet. | 2275                             |
| msg                   | Conteúdo da mensagem a ser enviada. Este valor deverá ser codificado em base64.                              | T2zDoSBtdW5kbyE=                 |

### Resposta da API

A API poderá retornar HTTP Status code 200, 400 ou 401, sendo:

| Código HTTP | Descrição                                                                                       | Exemplo                                               |
| ----------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| 200         | Mensagem enviada com sucesso, caso status = "OK", ou falha no envio caso status = "ERRO".       | "status": "OK", "msg": "Mensagem enviada com sucesso" |
| 400         | Parâmetros de entrada inválidos.                                                                |                                                       |
| 401         | Erro de autenticação. Loja bloqueada para integrações, ou dados inválidos em token e codFilial. |                                                       |

## Dúvidas comuns

<details>

<summary>Existe um ambiente de testes?</summary>

Não, mas é possível utilizar o mesmo token da API Pedidos, entretanto as mensagens não serão de fato enviadas ao número de Whatsapp.

</details>

<details>

<summary>Qual o limite de requisições?</summary>

30 requisições por minuto na API.

</details>

<details>

<summary>É possível enviar emojis, ou arquivos de mídia?</summary>

Emojis sim, mas arquivos de mídia não são suportados nesta versão da API.

</details>

***

{% columns %}
{% column %}

## **Dúvidas?**

Ficou com alguma dúvida? Para agilizar o atendimento, o ideal é <mark style="color:$success;">chamar no grupo de suporte do WhatsApp da sua loja</mark>. Assim, você será atendido com muito mais rapidez. \
\
Ou se preferir entre em contato agora mesmo pelo nosso numero abaixo:

* **Telefone:** (17) 3600-9682
* **E-mail:** <suporte@ccmpedidoonline.com.br>
  {% endcolumn %}

{% column %}

<figure><img src="https://1003358175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDKxuyONXreRvqLlMPi%2Fuploads%2FwS6TniVrfmVnp1NzI3OI%2Fccm%20pedidos%20cinza.png?alt=media&amp;token=c8028e55-7f1a-4b5c-af3b-9c70f104e01b" alt=""><figcaption></figcaption></figure>

{% endcolumn %}
{% endcolumns %}