messengers Business API

Canal oficial para integração com o messengers.
Início rápido, proteção anti-bloqueio, sem necessidade de manter o telefone ligado

CONECTAR MESSENGER API

API amigável para desenvolvedores para integração com CRM, bots, dados, etc.

Boletins informativos oficiais e bots
Envie mensagens aprovadas em nome da sua empresa sem correr o risco de ser bloqueado
Botões em mensagens
Adicione botões interativos à mensagem.
Mensajes Enriquecidos (imagens, arquivos, localização, vídeos, links, etc)
Velocidade máxima de entrega
Integração direta com a infraestrutura de TI do messengers para entrega de mensagens instantâneas.
100% das mensagens entregues

Preço

Assinatura Mensal
US $39/mês

APIs nativos y Webhooks de messengers

Integração rápida

Sem taxas ocultas

Livre 1.000 conversas / mês *

*
Além disso, a taxa para cada conversa é cobrada de acordo com os
preços das conversas de Chat-API

Construtor de chatbot básico

Atendimento ao cliente

Construtor de bots visual*

*
Oferta temporária
escolha esta taxa
Assinatura Anual
US $30/mês

APIs nativos y Webhooks de messengers

Integração rápida

Sem taxas ocultas

Livre 1.000 conversas / mês *

*
Além disso, a taxa para cada conversa é cobrada de acordo com os
preços das conversas de Chat-API

Construtor de chatbot básico

Atendimento ao cliente

Construtor de bots visual*

*
Oferta temporária
escolha esta taxa
Melhor preço

Ativação rápida e automatizada da conta de autoatendimento

Envie um modelo (iniciar um diálogo)

O messengers limita o conteúdo das mensagens de texto com as quais você pode iniciar uma conversa com um cliente ou continuar uma conversa 24 horas após a última mensagem do cliente. Esta mensagem deve ser um modelo pré-aprovado. O envio do modelo é cobrado, pois inicia a conversa. Se o cliente responder a você, você poderá se comunicar com ele gratuitamente por 24 horas a partir do momento em que receber a resposta. Saiba mais.

$data = [
    'phone' => '79995253422', // Receivers phone
    'template' => 'template_name', // Template name
    'namespace' => 'namespace_of_template', // Namespace of template
    'language' =>  ['code' => 'en', 'policy' => 'deterministic'], // Language parameters
];
$json = json_encode($data); // Encode data to JSON
// URL for request POST /message
$token = '83763g87x';
$instanceId = '777';
$url = "https://api.chat-api.com/instance{$instanceId}/sendTemplate?token={$token}";
// Make a POST request
$options = stream_context_create(['http' => [
        'method'  => 'POST',
        'header'  => 'Content-type: application/json',
        'content' => $json
    ]
]);
// Send a request
$result = file_get_contents($url, false, $options);
var request = require('request'); //bash: npm install request
// URL for request POST /message
const token = '83763g87x';
const instanceId = '777';
const url = `https://api.chat-api.com/instance${instanceId}/sendTemplate?token=${token}`;
var data = {
    phone: '79995253422', // Receivers phone
    template: "template_name",
    namespace : "namespace_of_template",
    language: {
        code: "en",
        policy: "deterministic"}
};
// Send a request
request({
    url: url,
    method: "POST",
    json: data
});
// URL for request POST /message
const token = '83763g87x';
const instanceId = '777';
const url = `https://api.chat-api.com/instance${instanceId}/sendTemplate?token=${token}`;
let data = {
    phone: '79995253422', // Receivers phone
    template: "template_name",
    namespace : "namespace_of_template",
    language: {
        code: "en",
        policy: "deterministic"}
};
// Send a request
$.ajax(url, {
    data : JSON.stringify(data),
    contentType : 'application/json',
    type : 'POST'
});
curl \
-d '{"phone": "79995253422","template": "template_name", "namespace" : "namespace_of_template", "language": { "code": "en", "policy": "deterministic"}}' \ # Phone and template parameters
-H "Content-Type: application/json" \ # Headers
-X POST \ # Type = POST
"https://api.chat-api.com/sendTemplate?token=83763g87x" # URL for request POST /message

Envie mensagem

Se o diálogo foi iniciado pelo cliente, o cliente pode responder com uma mensagem normal. Este diálogo também é pago, se você respondeu ao cliente. Você pode se comunicar com ele gratuitamente por 24 horas a partir do momento da resposta. Leia mais sobre o modelo de faturamento do Diálogo.

$data = [
    'phone' => '79995253422', // Receivers phone
    'body' => 'Hello, Andrew!', // Message
];
$json = json_encode($data); // Encode data to JSON
// URL for request POST /message
$url = 'https://api.chat-api.com/message?token=83763g87x';
// Make a POST request
$options = stream_context_create(['http' => [
        'method'  => 'POST',
        'header'  => 'Content-type: application/json',
        'content' => $json
    ]
]);
// Send a request
$result = file_get_contents($url, false, $options);
var request = require('request'); //bash: npm install request
// URL for request POST /message
var url = 'https://api.chat-api.com/message?token=83763g87x';
var data = {
    phone: '79995253422', // Receivers phone
    body: 'Hello, Andrew!', // Сообщение
};
// Send a request
request({
    url: url,
    method: "POST",
    json: data
});
// URL for request POST /message
var url = 'https://api.chat-api.com/message?token=83763g87x';
var data = {
    phone: '79995253422', // Receivers phone
    body: 'Hello, Andrew!', // Message
};
// Send a request
$.ajax(url, {
    data : JSON.stringify(data),
    contentType : 'application/json',
    type : 'POST'
});
curl \
-d '{"phone": "79995253422","body": "Hello, Andrew!"}' \ # Phone and message
-H "Content-Type: application/json" \ # Headers
-X POST \ # Type = POST
"https://api.chat-api.com/message?token=83763g87x" # URL for request POST /message

Configurar Webhook

Receba notificações de mensagens diretas por meio de solicitações http recebidas no seu servidor.

// First of all - set a webhook to URL like http://your_website.com/my_webhook_url.php

// Parse a webhook data
$data = json_decode(file_get_contents('php://input'), true);
foreach($data['messages'] as $message){ // Echo every message
    // Handle every message here
    // Add to the database or generate a response
}
// First of all - set a webhook to URL like http://your_website.com/my_webhook_url

// Require Express JS и Body Parser for JSON POST acceptance
var app = require('express')();
var bodyParser = require('body-parser');
app.use(bodyParser.json());

// Handle POST request
app.post('/my_webhook_url', function (req, res) {
    var data = req.body; // New messages in the "body" variable
    for (var i = 0; i < data.messages.length; i++) { // For each message
        var message = data.messages[i];
        console.log(message.author + ': ' + message.body); //Send it to console
    }
    res.send('Ok'); //Response does not matter
});

app.listen(80);

Gerenciamento de Perfil de Conta

Você pode visualizar e editar seu perfil do messengers. No entanto, se você quiser alterar o nome de exibição de uma conta, existem algumas regras.

$data = [
    'address' => '79995253422', // Recipient's phone
    'description' => 'Best Company', // Message
    'email' => '', // Email of the organization
    'vertical' => '' // The industry
];
$json = json_encode($data); // Let's encode the data in JSON
// URL for POST request /message
$token = '8376213g87x';
$instanceId = '777';
$url = 'https://api.chat-api.com/instance'.$instanceId.'/me?token='.$token;
// Let's form the context of an ordinary POST request
$options = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => 'Content-type: application/json',
    'content' => $json
]
]);
// Let's send a request
$result = file_get_contents($url, false, $options);

FAQ

O que é messengers Business API (MESAPI)?

Para conectar sua empresa com clientes no messengers, você precisa de um gateway API ou interface que mediará entre sua solução (sistema CRM, chat bot, plataforma de chat, ou algo mais) e os usuários do messenger. Esta interface é a solução oficial da Comp - messengers Business API. Saiba mais sobre API oficial do messengers Business do Chat API neste artigo.

Benefícios do messengers Business API

- Envio de mensagens gratuito. Sem o risco de ser banido, sem precisar manter o telefone ligado;
- Conexão rápida. Não há necessidade de verificar o negócio, comece a trabalhar com o número imediatamente;
- Até 100.000 mensagens por dia a partir de um número;
- 1.000 conversas grátis por mês;
- Botões interativos nas mensagens para rápida resposta do cliente;
- Número do messengers como cartão de visita da sua empresa;
- Uma marca de verificação verde e o nome da empresa no perfil do messengers depois de concordar com o Comp.

O Chat API fornece a API oficial do messengers Business?

Temos ajudado com sucesso a estabelecer comunicação com os clientes no messengers desde 2015, fornecendo acesso a API funcional, chat bots, plataformas de chat. A partir de 2020, começamos a conectar os usuários à API do messengers Business através do parceiro oficial da messengers API 360Dialog. Nossa solução é uma das mais acessíveis e funcionais em operação. Experimente e avalie por si mesmo .

Como se conectar?
O Chat API se conecta à API do messengers Business por meio do provedor Comp oficial. A conexão ocorre instantaneamente com a ajuda de uma nova abordagem de registro com verificação diferida.

Após o registro, você pode começar a testar imediatamente o funcionamento do número e configurar a integração, e a verificação da empresa, a aprovação do nome de exibição e a coordenação com a política da Comp são executadas em paralelo ao acesso ativo à API.


Procedimento de conexão:

Instruções detalhadas para conectar o número são fornecidas neste artigo. Abaixo está o procedimento geral e a abordagem para registrar um número MESAPI.

- Crie um novo projeto MESAPI na conta pessoal do Chat API;
- Preencha o formulário de inscrição;
- Vincule o cartão e assine;
- Gere uma chave API. Especifique a chave do API no Chat API da sua conta pessoal;
- Nesta fase, você já poderá trabalhar com o número, enviar e receber mensagens, mas com algumas restrições. Para expandir as capacidades do número, você precisa verificar seu negócio. Mais sobre verificação neste artigo.
- Aproveite o trabalho da API oficial messengers Business.

Quanto tempo leva para se conectar?

Com a ajuda de uma nova abordagem de registro (por meio do registro com verificação diferida), você obtém acesso à API do messengers Business quase que instantaneamente. O registro não leva mais de 5 minutos.

Quais números são adequados para o messengers Business API?

Todos os números são adequados para trabalhar com o API do messengers Business, desde que sejam ao mesmo tempo:

1 - teve a oportunidade de receber mensagens\ chamadas para verificação;

2 - não foram bloqueados no messengers.

Você também pode usar um número de telefone fixo, mas precisa de telefonia IP para funcionar com ele. Se você tiver um sistema IVR instalado, deverá desativá-lo ao executar o procedimento de verificação de números.

Se o número já estiver conectado à API do messengers Business por meio de outro provedor de API, esse número também poderá ser transferido para o Chat API usando o procedimento de migração de números.

Você pode aprender mais sobre os recursos de escolher um número para o API de messengers Business neste artigo.

Importante! Um número conectado à API do messengers Business não pode funcionar em Aplicativos do messengers. Antes de começar a conectar o número, você precisa excluir sua conta do messengers. Leia mais aqui.

Uma pessoa jurídica pode conectar um número da API do messengers Business?

O Comp Business Manager é uma ferramenta para trabalhar com empresas, portanto, para obter um FBID (o parâmetro necessário para conectar o MESAPI), você precisa ter uma entidade legal ou o status de um empresário individual. Você deve ser uma organização e ter documentos que confirmem isso, todo o resto depende das formas de organização legal em seu país.

Como faço para obter uma marca de seleção verde no messengers?

O fornecimento de uma marca verde e o status de "parceiro comercial Oficial" é determinado pelo próprio Comp e estabelece os seguintes critérios:

- Verificação no Comp Business Manager;
- Acesso à API do messengers Business e cumprimento das políticas Comp;
- Autenticação de dois fatores no Comp Business Manager;
- O segundo e mais alto nível de confiança no número MESAPI;
- Uma marca conhecida e reconhecida.

Dicas, instruções e armadilhas são descritas detalhadamente neste artigo. Ajudamos todos os nossos clientes a obter uma marca de verificação verde gratuitamente.

Quanto custa conectar ao messengers Business API?

O custo de trabalhar com o número MESAPI é dividido em dois segmentos:

1 - pagamento mensal para hospedar o número - 39$ por mês ou 30$ se a assinatura for emitida por um ano.

2 - pagamento por diálogos abertos com o cliente, mais sobre isso aqui.

Todos os meses você começa com 1000 diálogos gratuitos.

Escrevemos mais sobre a formação de preços e o procedimento de pagamento neste artigo.

Cancelamento da assinatura. A regra do mês de reserva.

Preste atenção, talvez não à regra mais justa, mas obrigatória, de acordos mútuos, que é declarada pelo Provedor do API. Para simplificar, chamamos essa regra de "mês de Reserva".

Se você decidir abandonar o messengers Business API e excluir o número, o procedimento de pagamento será o seguinte:
- Primeiro, os fundos do mês em que o número foi excluído serão debitados integralmente, mesmo que você exclua o número nos primeiros dias do mês.
- Em segundo lugar, para o mês seguinte ao mês em que o número foi excluído, o dinheiro também será debitado, como para um período messengers Business API totalmente funcional.

Também acreditamos que isto não é totalmente justo, agora que este procedimento está sendo discutido e, esperamos, que possa ser alterado em breve, nós definitivamente o notificaremos sobre isto.

Se você cancelar sua assinatura ou não houver fundos suficientes no cartão, o número será bloqueado até que as circunstâncias sejam esclarecidas.

Modelo de Mensagens

Estes são a forma e o conteúdo da Comp aprovados das mensagens usadas para abrir um diálogo com o cliente. Leia mais sobre isso neste artigo

Caixa de diálogo em 24 horas

Este é um intervalo de tempo que começa a partir do momento do início da comunicação e termina 24 horas após a primeira mensagem do cliente entregue na caixa de diálogo. Todas as mensagens dentro da janela de 24 horas são gratuitas e isentas do uso de modelos.

messengers Business App e messengers Business API

Estes conceitos são freqüentemente confundidos. A messengers Business App é uma aplicação comercial que possui funcionalidades avançadas para trabalhar com a própria aplicação messengers. A messengers Business API é uma interface ou gateway que lhe permitirá automatizar e otimizar a comunicação com os usuários usando bots ou operadores conectados à messengers via sistemas CRM ou outras plataformas.

Nome de exibição (Display name)

Este é o nome de usuário ou nome da empresa exibido no messengers. Mais detalhes sobre isso neste artigo.

Registo com verificação diferida

Uma nova abordagem para o registro do cliente na MESAPI. É caracterizada pelo fato de você receber imediatamente um número ativo. Leia mais sobre isto neste artigo.

image

O que nossos clientes dizem

Confiança de milhares de desenvolvedores

Ribhu

Omni-channel for hotels

Good UI and self serviceable (can create an instance from scratch and pay from my card and get running with messengers. No need to email anyone and all the steps are automated. This is great!)

Gonzalo

Chatbot developer

It’s good. The API works fast, messengers messages arrive in seconds.

Jeff

Internet Technology University

It is good and stable! There could be more opportunities for collaboration. Currently it is one-side API, but it has potential for more.

João Ignácio

Software Architect and Development Manager

My consensus is that the service is great, always on the air and the support meets whenever we need it. Something very good is that several of my requests for both problems and improvements have been taken into account and implemented where possible.

PREÇO E CONEXÃO

Custo mensal a partir de US$ 30 /mês para uma conta messengers.
A partir de 5 números, o preço será mais baixo. Se você conectar mais números, condições individuais podem ser acordadas.
O preço inclui suporte técnico, os primeiros 1000 diálogos por mês e todas as características da API oficial.

Obtenha o oficial messengers Business API