Vários operadores um único número de WhatsApp!

Envie e receba mensagens via WhatsApp com quantos operadores precisar.
Api por apenas R$0,015/mensagem, ou CRM com envio ilimitado! =)

Documentação API V1

Abaixo, todos os EndPoints usados ​​para consumir nossa API.

Para usar nossa API, você precisará de:


  • E-mail
  • Senha
  • Celular_id
Estas informações são repassadas por nossa equipe após o pedido de uma conta.

Duvidas? Temos uma àrea de FAQ com muitas informações e diversos canais para te auxiliar, como WhatsApp, Ticket, [email protected] e telefone +55 11 3230-1613.

Todos os endpoints são requisitados por verbo POST

Todos os retornos são em formato JSON

Login:

  • POST https://whatsapp.fcati.com.br/api/login
  • REQUEST
  • RESPONSE 200 | {token}

O login é necessário para obter um token. Com o token em mãos você poderá utilizar os demais endpoints


// Exemplo em PHP
function login()
{
    use GuzzleHttp\Client;

    $client = new Client();

    $login = ['email' => "[email protected]",'password' => "secret"];

    $response = $client->request('POST', 'http://whatsapp.fcati.com.br/api/login',['form_params' => $login]);

    $response = json_decode($response->getBody()->getContents());

    // print_r($response->token); // Shows token

    return $response->token;
}

            

Emparelhar:

Passo 1) Este endpoind deve ser chamado ANTES de chamar o ENDPOINT->EMPARELHAR para desconectar o aparlho

  • POST https://whatsapp.fcati.com.br/api/pre_emparelhar
  • REQUEST celular_id
  • RESPONSE 200 | {status}

Passo 2) Este endpoind deve ser chamado após o passo 1 de tempos em tempos até visualizar o QRCODE indicamos a cada 5 segundos

  • POST https://whatsapp.fcati.com.br/api/emparelhar
  • REQUEST celular_id
  • RESPONSE 200 | {qrcode} base64

// Exemplo em PHP
function emprarelhar()
{
    use GuzzleHttp\Client;

    $client     = new Client();
    $token      = $this->login();  // Used result of login Endpoint
    $celular_id = ['celular_id' => 1];
    $headers    = ['Authorization' => 'Bearer ' . $token, 'Accept' => 'application/json'];

    try
    {
        $response = $client->request('POST', 'http://whatsapp.fcati.com.br/api/emparelhar',
        [
            'form_params' => $celular_id,
            'headers' => $headers,
        ]);

        $response = json_decode($response->getBody()->getContents(), true);
        echo $response;
    }
    catch (\Exception $e)
    {
        return $e->getMessage();
    }
}

// Podemos visualizar o QRCODE usando o exemplo abaixo:
<\img alt="qrcode" src="response of this endpoint" width="200" eight="200" style="display: block;">

            

Enviar/Send:

  • POST https://whatsapp.fcati.com.br/api/send
  • REQUEST
    • celular_id: 1 | integer
    • whatsapp: 5511987654321 | integer em formato internacional
    • midia: texto | temos 3 tipos: "texto", "imagem", "arquivo"
    • url_anexo: Opcional. Necessário apenas se midia="imagem" ou midia="arquivo"
    • mensagem: texto para envio em caso de ser texto
  • RESPONSE 200 | {'message queued', idmsg }

Endpoind de envio de mensagem, imagem ou arquivos como PDF, Office, etc


// Exemplo em PHP de envio de um arquivo em PDF
function send()
{
    use GuzzleHttp\Client;

    $token = $this->login();  // Used result of login Endpoint
    $client = new Client();

    $data = [
                'celular_id' => "1234",
                'whatsapp'   => "5511987654321",
                'mensagem'   => "anexo",
                'midia'      => "arquivo",
                'url_anexo'  => "https://site.com/arquivo.pdf",
            ];

    $headers = [
                   'Authorization' => 'Bearer ' . $token,
                   'Accept'        => 'application/json',
               ];

    try
    {
        $response = $client->request('POST', 'http://whatsapp.fcati.com.br/api/send', [
            'form_params' => $data,
            'headers' => $headers,
        ]);

        return  $response->getStatusCode();
    }
    catch (\Exception $e)
    {
        return  $e->getMessage();
    }
}

            

Status:

  • POST https://whatsapp.fcati.com.br/api/status
  • REQUEST celular_id
  • RESPONSE 200 | {logado, pronto_p_envio, nr_telefone, nivel_bateria}

Este endpoint mostra status do Celular, como Bateria e se está conectado ao nosso sistema


// Exemplo em PHP
function status()
{
    use GuzzleHttp\Client;

    $client     = new Client();
    $token      = $this->login();  // Used result of login Endpoint
    $celular_id = ['celular_id' => 1234];
    $headers    = ['Authorization' => 'Bearer ' . $token, 'Accept' => 'application/json'];

    try
    {
        $response = $client->request('POST', 'http://whatsapp.fcati.com.br/api/status',
        [
            'form_params' => $celular_id,
            'headers' => $headers,
        ]);

        $response = json_decode($response->getBody()->getContents(), true);
        echo $response;
    }
    catch (\Exception $e)
    {
        return $e->getMessage();
    }
}

// Podemos visualizar o QRCODE usando o exemplo abaixo:
<\img alt="qrcode" src="response of this endpoint" width="200" eight="200" style="display: block;">

            

Listar:

  • POST https://whatsapp.fcati.com.br/api/list
  • REQUEST
    • celular_id: 1234 | integer
    • data_inicial: 2020-01-01 | Ano-Mes-Dia
    • data_final: 2020-02-01 | Ano-Mes-Dia
  • RESPONSE 200 | { list of messages }

Endpoind que lista todas as msgs de acordo com o range de datas inseridas


// Exemplo em PHP
function list()
{
    use GuzzleHttp\Client;

    $token = $this->login();  // Used result of login Endpoint
    $client = new Client();

    $data = [
                'celular_id'    => "1234",
                'data_inicial'  => "2020-01-01",
                'data_final'    => "2020-01-01",
            ];

    $headers = [
                   'Authorization' => 'Bearer ' . $token,
                   'Accept'        => 'application/json',
               ];

    try
    {
        $response = $client->request('POST', 'http://whatsapp.fcati.com.br/api/list', [
            'form_params' => $data,
            'headers' => $headers,
        ]);

        return  $response->getStatusCode();
    }
    catch (\Exception $e)
    {
        return  $e->getMessage();
    }
}

            

Receber / via Webhook:

Passo 1) O seu Webhook deve ser pré-configurado via abertura de chamado técnico / ticket.

  • POST Em sua URL já pré configurada -> ex: https://meusite.com.br/recebimento_whatsapp
  • RESPONSE
    • celular_id: 1234 | integer
    • celular_cliente: Numero do Celular do Cliente
    • nome_cliente: Nome configurado no WhatsApp do Cliente
    • horario: Horario em formato UNIX
    • mensagem: Recebe caso seja texto
    • ## CAMPOS OPCIONAIS CASO DE MIDIAS, LOCALIZAÇÃO ##
    • mimetype:
    • width:
    • height:
    • size:
    • referencia:
    • legenda:
    • lat:
    • lng:
    • loctipo:
    • idlog: idmsg recebido no envio da msg.
    • codigo_status: 1= enviado 2= recebido 3= visualizado
    • referencia_status: Enviado , Recebido , Visualizado
    • base64: arquivo codificado em base64

WebHook de recebimento de msgs.