Enviar localização – Central de Atendimento

Método responsável por enviar uma localização fixa aos seus contatos, muito utilizado para enviar a localização de um endereços.

Tipo	URL
`POST`	https://api.plugzapi.com.br/instances/SUA_INSTANCIA/token/SEU_TOKEN/send-location

Atributos obrigatórios

Atributos	Tipo	Descrição
phone	string	Telefone (ou ID do grupo para casos de envio para grupos) do destinatário no formato DDI DDD NÚMERO Ex: 551199999999. IMPORTANTE Envie somente números, sem formatação ou máscara
title	string	Título para sua localização ex: Minha casa
address	string	Endereço da localização que esta enviando composto por logradouro, número, bairro, cidade, UF e CEP, tudo separado por vírgula
latitude	string	Latitude da localização enviada
longitude	string	Longitude da localização enviada

Opcionais

Atributos	Tipo	Descrição
messageId	String	Atributo utilizado para responder uma mensagem do chat, basta adicionar o messageId da mensagem que queira responder neste atributo
delayMessage	number	Nesse atributo um delay é adicionado na mensagem. Você pode decidir entre um range de 1~15 sec, significa quantos segundos ele vai esperar para enviar a próxima mensagem. (Ex "delayMessage": 5, ). O delay default caso não seja informado é de 1~3 sec

Request Body:

{
"phone":"5511999998888",
"title":"Google Brasil",
"address":"Av. Brg. Faria Lima, 3477 - Itaim Bibi, São Paulo - SP, 04538-133",
"latitude":"-23.0696347",
"longitude":"-50.4357913"
}

Response

200

Atributos	Tipo	Descrição
zaapId	string	id no PlugMessage
messageId	string	id no whatsapp

Exemplo:

{
"zaapId":"3999984263738042930CD6ECDE9VDWSA",
"messageId":"D241XXXX732339502B68"
}

405

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.

415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"

Alguns exemplos para auxiliar a implementação

Exemplo em PHP

<?php

$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => "https://api.plugzapi.com.br/instances/SUA_INSTANCIA/token/SEU_TOKEN/send-link", 
 CURLOPT_RETURNTRANSFER => true,
 CURLOPT_ENCODING => "",
 CURLOPT_MAXREDIRS => 10,
 CURLOPT_TIMEOUT => 30,
 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
 CURLOPT_CUSTOMREQUEST => "POST",
 CURLOPT_POSTFIELDS => "{\"phone\": \"5511999998888\",\"title\": \"Google Brasil\",\"address\": \"Av. Brg. Faria Lima, 3477 - Itaim Bibi, São Paulo - SP, 04538-133\",\"latitude\": \"-23.0696347\",\"longitude\": \"-50.4357913\"}",
 CURLOPT_HTTPHEADER => array(
"content-type: application/json"
   ),
 ));

$response = curl_exec($curl); 
 $err = curl_error($curl); 

 curl_close($curl);

if ($err) {
echo"cURL Error #:" . $err;
 } else { 
echo$response;
 }

Exemplo em Node.js

var http = require("https");

var options = {
"method": "POST",
"hostname": "api.plugzapi.com.br",
"port": null,
"path": "/instances/SUA_INSTANCIA/token/SEU_TOKEN/send-link",
"headers": {}
};

var req = http.request(options, function (res) {
var chunks = [];

res.on("data", function (chunk) {
chunks.push(chunk);
});

res.on("end", function () {
var body = Buffer.concat(chunks);
console.log(body.toString());
});
});

req.write(JSON.stringify({
phone: '5511999998888',
title: 'Google Brasil',
address: 'Av. Brg. Faria Lima, 3477 - Itaim Bibi, São Paulo - SP, 04538-133',
latitude: '-23.0696347',
longitude: '-50.4357913'
}));
req.end();

Exemplo em C#

var client = new RestClient("https://api.plugzapi.com.br/instances/SUA_INSTANCIA/token/SEU_TOKEN/send-link");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddParameter("undefined", "{\"phone\": \"5511999998888\",\"title\": \"Google Brasil\",\"address\": \"Av. Brg. Faria Lima, 3477 - Itaim Bibi, São Paulo - SP, 04538-133\",\"latitude\": \"-23.0696347\",\"longitude\": \"-50.4357913\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Request Body:

Response

Artigos relacionados